Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SqlDataSource.ConnectionString-Eigenschaft

.NET Framework 3.0

Ruft die für den ADO.NET-Anbieter spezifische Zeichenfolge ab, die das SqlDataSource-Steuerelement für die Verbindung zu einer zugrunde liegenden Datenbank verwendet, oder legt diese Zeichenfolge fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

C++

public virtual string ConnectionString { get; set; }

/** @property */
public String get_ConnectionString ()

/** @property */
public void set_ConnectionString (String value)

JScript

public function get ConnectionString () : String

public function set ConnectionString (value : String)

XAML

Nicht zutreffend.

Eigenschaftenwert

Eine für den .NET Framework-Datenanbieter spezifische Zeichenfolge, mit der die SqlDataSource eine Verbindung zu der SQL-Datenbank herstellt, die es darstellt. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Das SqlDataSource-Steuerelement kann mit einer Vielzahl von ADO.NET-Anbietern sowie der anbieterspezifischen Syntax für die Verbindungszeichenfolge verwendet werden, mit der die Verbindung zu einer zugrunde liegenden Datenquelle hergestellt wird.

Hinweis:
Wenn Sie nicht mit den Datenzugriffsfeatures in ASP.NET 2.0 vertraut sind, sollten Sie vor dem Fortfahren einige der folgenden Themen lesen:

Wenn Sie die ConnectionString-Eigenschaft ändern, wird das DataSourceChanged-Ereignis ausgelöst und bewirkt eine erneute Bindung aller Steuerelemente, die an das SqlDataSource-Steuerelement gebunden sind.

Sicherheitshinweis
Weitere Informationen zum Speichern einer Verbindungszeichenfolge finden Sie unter Gewusst wie: Sichern von Verbindungszeichenfolgen bei der Verwendung von Datenquellensteuerelementen.

Thema	Position
Gewusst wie: Herstellen einer Verbindung zu einer ODBC-Datenbank mithilfe des SqlDataSource-Steuerelements	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Herstellen einer Verbindung zu einer ODBC-Datenbank mithilfe des SqlDataSource-Steuerelements (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Herstellen einer Verbindung zu einer ODBC-Datenbank mithilfe des SqlDataSource-Steuerelements (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiel

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die ConnectionString-Eigenschaft zum Herstellen einer Verbindung zu einer Microsoft SQL Server-Datenbank festgelegt wird und wie die Ergebnisse der SelectCommand-Eigenschaft in einem GridView-Steuerelement angezeigt werden. Im zweiten Codebeispiel wird ein komplexeres Szenario veranschaulicht, in dem mithilfe eines SqlDataSource-Steuerelements Daten in einer kennwortgeschützten Microsoft Access-Datenbank angezeigt und aktualisiert werden.

Im folgenden Codebeispiel wird veranschaulicht, wie die ConnectionString-Eigenschaft zum Herstellen einer Verbindung zu einer SQL Server-Datenbank festgelegt wird und wie die Ergebnisse der SelectCommand-Eigenschaft in einem GridView-Steuerelement angezeigt werden.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Im folgenden Codebeispiel wird ein komplexeres Szenario als das vorangegangene veranschaulicht. Hier werden mithilfe eines SqlDataSource-Steuerelements Daten in einer kennwortgeschützten Microsoft Access-Datenbank angezeigt und aktualisiert. Da die SqlDataSource mit Microsoft Access verwendet wird, wird die ProviderName-Eigenschaft auf den System.Data.OleDb-Anbieter festgelegt; die ConnectionString-Eigenschaft hingegen wird auf eine entsprechende Zeichenfolge für eine Microsoft Access-Datenbank festgelegt, die über eine UNC-Freigabe verfügt. Ein GridView-Steuerelement zeigt Bestellungen mit Lieferdaten an. Sie können eine Bestellung aktualisieren, indem Sie das entsprechende Kontrollkästchen markieren und dann auf die Schaltfläche Aktualisieren klicken.

<%@Page  Language="C#" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  // This method is an example of batch updating using a
  // data source control. The method iterates through the rows
  // of the GridView, extracts each CheckBox from the row and, if
  // the CheckBox is checked, updates data by calling the Update
  // method of the data source control, adding required parameters
  // to the UpdateParameters collection.
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add(new Parameter("date",TypeCode.DateTime,DateTime.Now.ToString()));
      MyAccessDataSource.UpdateParameters.Add(new Parameter("orderid",TypeCode.String,oid));
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:SqlDataSource
        id="MyAccessDataSource"
        runat="server"
        ProviderName="<%$ ConnectionStrings:MyPasswordProtectedAccess.providerName%>"
        ConnectionString="<%$ ConnectionStrings:MyPasswordProtectedAccess%>"
        SelectCommand="SELECT OrderID, OrderDate, RequiredDate, ShippedDate FROM Orders WHERE EmployeeID=?"
        UpdateCommand="UPDATE Orders SET ShippedDate=? WHERE OrderID = ?">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceID="MyAccessDataSource"
        AllowPaging="True"
        PageSize="10"
        AutoGenerateColumns="False">
          <columns>
            <asp:TemplateField HeaderText="">
              <ItemTemplate>
                <asp:CheckBox runat="server" />
              </ItemTemplate>
            </asp:TemplateField>
            <asp:BoundField HeaderText="Order" DataField="OrderID" />
            <asp:BoundField HeaderText="Order Date" DataField="OrderDate" />
            <asp:BoundField HeaderText="Required Date" DataField="RequiredDate" />
            <asp:BoundField HeaderText="Shipped Date" DataField="ShippedDate" />
          </columns>
      </asp:GridView>

      <asp:Button
        id="Button1"
        runat="server"
        Text="Update the Selected Records As Shipped"
        OnClick="UpdateRecords" />

      <asp:Label id="Label1" runat="server" />

    </form>
  </body>
</html>

<%@Page  Language="VJ#" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    private void UpdateRecords(Object source, System.EventArgs e)
    {
        // This method is an example of batch updating using a
        // data source control. The method iterates through the rows
        // of the GridView, extracts each CheckBox from the row and, if
        // the CheckBox is checked, updates data by calling the Update
        // method of the data source control, adding required parameters
        // to the UpdateParameters collection.
        CheckBox cb;
        for (int iCtr = 0; 
                iCtr < this.GridView1.get_Rows().get_Count(); iCtr++) {
            GridViewRow row = this.GridView1.get_Rows().get_Item(iCtr);
            cb = (CheckBox)row.get_Cells().get_Item(0).get_Controls().get_Item(1);
            if (cb.get_Checked()) {
                String oid = (String)(row.get_Cells().get_Item(1).get_Text());
                MyAccessDataSource.get_UpdateParameters().Add(new Parameter(
                    "date", System.TypeCode.DateTime, System.DateTime.get_Now().ToString()));
                MyAccessDataSource.get_UpdateParameters().Add(new Parameter(
                    "orderid", System.TypeCode.String, oid));
                MyAccessDataSource.Update();
                MyAccessDataSource.get_UpdateParameters().Clear();
            }
        }
    } //UpdateRecords
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:SqlDataSource
        id="MyAccessDataSource"
        runat="server"
        ProviderName="System.Data.OleDb"
        ConnectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=\\uncpath\Northwind_PasswordProtected.mdb;Mode=3;Jet OLEDB:Database Password=myPassword;"
        SelectCommand="SELECT OrderID, OrderDate, RequiredDate, ShippedDate FROM Orders WHERE EmployeeID=?"
        UpdateCommand="UPDATE Orders SET ShippedDate=? WHERE OrderID = ?">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceID="MyAccessDataSource"
        AllowPaging="True"
        PageSize="10"
        AutoGenerateColumns="False">
          <Columns>
            <asp:TemplateField HeaderText="">
              <ItemTemplate>
                <asp:CheckBox runat="server" />
              </ItemTemplate>
            </asp:TemplateField>
            <asp:BoundField HeaderText="Order" DataField="OrderID" />
            <asp:BoundField HeaderText="Order Date" DataField="OrderDate" />
            <asp:BoundField HeaderText="Required Date" DataField="RequiredDate" />
            <asp:BoundField HeaderText="Shipped Date" DataField="ShippedDate" />
          </Columns>
      </asp:GridView>

      <asp:Button
        id="Button1"
        runat="server"
        Text="Update the Selected Records As Shipped"
        OnClick="UpdateRecords" />

      <asp:Label id="Label1" runat="server" />

    </form>
  </body>
</html>

Plattformen

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0, 2.0

Siehe auch

Referenz

SqlDataSource-Klasse
SqlDataSource-Member
System.Web.UI.WebControls-Namespace
ProviderName

Weitere Ressourcen

Überblick über den ASP.NET-Datenzugriff
Neues beim ASP.NET-Datenzugriff
Datengebundene Webserver-Steuerelemente
SqlDataSource-Webserver-Steuerelement
Übersicht über den Lebenszyklus von ASP.NET-Seiten

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)