Udostępnij za pośrednictwem

SqlDataSource.ConnectionString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia parametry połączenia specyficzne dla dostawcy ADO.NET używane przez kontrolkę SqlDataSource do nawiązywania połączenia z bazową bazą danych.

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

Wartość właściwości

String

Ciąg specyficzny dla dostawcy danych programu .NET Framework używany przez SqlDataSource do nawiązywania połączenia z bazą danych SQL, którą reprezentuje. Wartość domyślna to pusty ciąg ("").

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić właściwość ConnectionString w celu nawiązania połączenia z bazą danych programu SQL Server i wyświetlić wyniki właściwości SelectCommand w kontrolce GridView.

<%@ 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>

Uwagi

Kontrolkę SqlDataSource można używać z różnymi dostawcami ADO.NET i składnią parametrów połączenia używanych do nawiązywania połączenia z bazowym źródłem danych jest specyficzny dla dostawcy.

Podczas konfigurowania kontrolki SqlDataSource należy ustawić właściwość ProviderName na typ bazy danych (wartość domyślna to System.Data.SqlClient), a właściwość ConnectionString ustawić na parametry połączenia zawierające informacje wymagane do nawiązania połączenia z bazą danych. Zawartość parametrów połączenia różni się w zależności od typu bazy danych, do której jest uzyskiwana kontrola źródła danych. Na przykład kontrolka SqlDataSource wymaga nazwy serwera, nazwy bazy danych (katalogu) i informacji o sposobie uwierzytelniania użytkownika podczas nawiązywania połączenia z programem SQL Server. Aby uzyskać informacje o zawartości parametrów połączenia, zobacz właściwość ConnectionString klasy SqlConnection, ConnectionString właściwości klasy OracleConnection, ConnectionString dla klasy OleDbConnection lub właściwość ConnectionString dla klasy OdbcConnection.

Jeśli zmienisz właściwość ConnectionString, zostanie zgłoszone zdarzenie DataSourceChanged, co powoduje, że wszystkie kontrolki powiązane z kontrolką SqlDataSource zostaną ponownie powiązane.

Ważny

Aby uzyskać informacje na temat przechowywania parametrów połączenia, zobacz How To: Secure Connection Strings when Using Data Source Controls.

Dotyczy

Zobacz też