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


SqlDataSource.ProviderName Свойство

Определение

Возвращает или задает имя поставщика данных платформы .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

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

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

Атрибуты

Примеры

Этот раздел содержит два примера кода. В первом коде показано, как подключиться к базе данных 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 .

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

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

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