SqlDataSource.ProviderName Свойство

  • Ссылка

Определение

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

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

public:
 virtual property System::String ^ ProviderName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string ProviderName { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string ProviderName { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ProviderName : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ProviderName : string with get, set
Public Overridable Property ProviderName As String

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

String

Имя поставщика данных, используемого элементом управления SqlDataSource; если поставщик не задан, используется поставщик ADO.NET для Microsoft SQL Server. По умолчанию используется поставщик ADO.NET для Microsoft SQL Server.

Атрибуты
TypeConverterAttribute

Примеры

Этот раздел содержит два примера кода. В первом коде показано, как подключиться к базе данных SQL Server с помощью поставщика данных платформа .NET Framework по умолчанию для SQL Server элемента SqlDataSource управления , .System.Data.SqlClient Во втором примере кода показано, как подключиться к базе данных ODBC с помощью поставщика данных платформа .NET Framework для ODBC, .System.Data.Odbc

В следующем примере кода показано, как подключиться к базе данных SQL Server с помощью поставщика данных по умолчанию для SqlDataSource элемента управления , .System.Data.SqlClient Если ProviderName свойство не задано явным образом, используется поставщик по умолчанию. Свойство ConnectionString зависит от поставщика.

<%@ 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 LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </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 LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

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

В следующем примере кода, который функционально совпадает с предыдущим примером кода, показано, как подключиться к базе данных ODBC с помощью поставщика данных платформа .NET Framework для ODBC, .System.Data.Odbc Свойству ConnectionString присваивается имя источника данных ODBC (DSN), которое используется для подключения к базе данных ODBC.

<!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>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT LastName FROM Employees;">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox>

    </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>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=myodbc3-test;"
          SelectCommand="SELECT LastName FROM Employees;">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox>

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

Комментарии

В платформа .NET Framework входят следующие поставщики данных:

  • Поставщик System.Data.SqlClient является поставщиком данных по умолчанию платформа .NET Framework для SQL Server.

  • Поставщик System.Data.OleDb является поставщиком данных платформа .NET Framework для OLE DB.

  • Поставщик System.Data.Odbc является поставщиком данных платформа .NET Framework для ODBC.

  • Поставщик System.Data.OracleClient является поставщиком данных платформа .NET Framework для Oracle.

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

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

Список доступных поставщиков указывается в подразделе DbProviderFactoriessystem.data раздела файла Machine.config.

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

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