SqlDataSource.ConnectionString Свойство

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает или задает строку подключения для конкретного поставщика ADO.NET, которую элемент управления SqlDataSource использует для подключения к базовой базе данных.

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

Значение свойства

String

Строка поставщика данных .NET Framework, которая используется SqlDataSource для подключения к базе данных SQL, представляющей ее. Значение по умолчанию — пустая строка ("").

Примеры

В следующем примере кода показано, как задать свойство ConnectionString для подключения к базе данных SQL Server и отображения результатов свойства SelectCommand в элементе управления 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>

Элемент управления SqlDataSource можно использовать с различными поставщиками ADO.NET, а синтаксис строки подключения, используемой для подключения к базовому источнику данных, зависит от поставщика.

При настройке элемента управления SqlDataSource задайте для свойства ProviderName тип базы данных (значение по умолчанию — System.Data.SqlClient), а свойство ConnectionString — строку подключения, содержащую сведения, необходимые для подключения к базе данных. Содержимое строки подключения отличается в зависимости от типа базы данных, к какой базе данных осуществляется доступ к элементу управления версиями данных. Например, элемент управления SqlDataSource требует имени сервера, имени базы данных (каталога) и сведений о том, как пройти проверку подлинности пользователя при подключении к SQL Server. Сведения о содержимом строк подключения см. в свойстве ConnectionString для класса SqlConnection, свойства ConnectionString для класса OracleConnection, свойства ConnectionString для класса OleDbConnection или свойства ConnectionString для класса OdbcConnection.

При изменении свойства ConnectionString вызывается событие DataSourceChanged, что приводит к повторной привязке всех элементов управления, привязанных к элементу управления SqlDataSource.

Важный

Сведения о хранении строки подключения см. в разделе Практическое руководство. Защита строк подключения при использовании элементов управления источниками данных.

Применяется к

См. также раздел

ProviderName
элементов управления веб-сервером источника данных
элемента управления Веб-сервером SqlDataSource
Обзор жизненного цикла страниц ы ASP.NET

Поделиться через