SqlDataSource.ConnectionString Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die ADO.NET anbieterspezifische Verbindungszeichenfolge ab, die vom SqlDataSource-Steuerelement zum Herstellen einer Verbindung mit einer zugrunde liegenden Datenbank verwendet wird, oder legt diese fest.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public virtual string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overridable Property ConnectionString As String

Eigenschaftswert

String

Eine .NET Framework-datenanbieterspezifische Zeichenfolge, die vom SqlDataSource zum Herstellen einer Verbindung mit der sql-Datenbank verwendet wird, die sie darstellt. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ConnectionString-Eigenschaft festgelegt wird, um eine Verbindung mit einer SQL Server-Datenbank herzustellen und die Ergebnisse der SelectCommand-Eigenschaft in einem GridView-Steuerelement anzuzeigen.

<%@ Page Language="C#" %>

<!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>

<%@ Page Language="VB" %>

<!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>

Hinweise

Das SqlDataSource-Steuerelement kann mit einer Vielzahl von ADO.NET Anbietern verwendet werden, und die Syntax der Verbindungszeichenfolge, die zum Herstellen einer Verbindung mit einer zugrunde liegenden Datenquelle verwendet wird, ist spezifisch für den Anbieter.

Wenn Sie ein SqlDataSource-Steuerelement konfigurieren, legen Sie die ProviderName-Eigenschaft auf den Datenbanktyp fest (der Standardwert ist System.Data.SqlClient), und Sie legen die ConnectionString-Eigenschaft auf eine Verbindungszeichenfolge fest, die Informationen enthält, die erforderlich sind, um eine Verbindung mit der Datenbank herzustellen. Der Inhalt einer Verbindungszeichenfolge unterscheidet sich je nach Datenbanktyp, auf den das Datenquellensteuerelement zugreift. Das SqlDataSource-Steuerelement erfordert z. B. einen Servernamen, einen Datenbanknamen (Katalognamen) und Informationen zur Authentifizierung des Benutzers beim Herstellen einer Verbindung mit einem SQL Server. Informationen zum Inhalt von Verbindungszeichenfolgen finden Sie in der ConnectionString Eigenschaft für die SqlConnection Klasse, ConnectionString Eigenschaft für die OracleConnection Klasse, ConnectionString Eigenschaft für die OleDbConnection Klasse oder die ConnectionString Eigenschaft für die OdbcConnection Klasse.

Wenn Sie die eigenschaft ConnectionString ändern, wird das DataSourceChanged-Ereignis ausgelöst, wodurch alle Steuerelemente ausgelöst werden, die an das SqlDataSource-Steuerelement gebunden sind.

Wichtig

Informationen zum Speichern einer Verbindungszeichenfolge finden Sie unter How To: Secure Connection Strings when Using Data Source Controls.

Gilt für:

Weitere Informationen