SqlDataSource.ProviderName Свойство

Определение

Возвращает или задает имя поставщика данных платформы .NET Framework, который используется элементом управления SqlDataSource для подключения к базовому источнику данных.Gets or sets the name of the .NET Framework data provider that the SqlDataSource control uses to connect to an underlying data source.

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=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[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; }
member this.ProviderName : string with get, set
Public Overridable Property ProviderName As String

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

Имя поставщика данных, используемого элементом управления SqlDataSource; если поставщик не задан, используется поставщик ADO.NET для Microsoft SQL Server.The name of the data provider that the SqlDataSource uses; otherwise, the ADO.NET provider for Microsoft SQL Server, if no provider is set. По умолчанию используется поставщик ADO.NET для Microsoft SQL Server.The default is the ADO.NET provider for Microsoft SQL Server.

Атрибуты

Примеры

Этот раздел содержит два примера кода.This section contains two code examples. В первом коде показано SqlDataSource System.Data.SqlClient, как подключиться к базе данных SQL Server с помощью поставщика данных .NET Framework по умолчанию для SQL Server элемента управления.The first code demonstrates how to connect to a SQL Server database using the default .NET Framework Data Provider for SQL Server for the SqlDataSource control, the System.Data.SqlClient. Во втором примере кода показано, как подключиться к базе данных ODBC с помощью поставщика данных .NET Framework для ODBC, System.Data.Odbc.The second code example demonstrates how to connect to an ODBC database using the .NET Framework Data Provider for ODBC, the System.Data.Odbc.

В следующем примере кода показано SqlDataSource System.Data.SqlClient, как подключиться к SQL Server базе данных с помощью поставщика данных по умолчанию для элемента управления,.The following code example demonstrates how to connect to a SQL Server database using the default data provider for the SqlDataSource control, the System.Data.SqlClient. ProviderName Если свойство не задано явно, используется поставщик по умолчанию.Whenever the ProviderName property is not explicitly set, the default provider is used. ConnectionString Свойство зависит от поставщика.The ConnectionString property is provider-specific.

<%@ 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.The following code example, which is functionally the same as the preceding code example, demonstrates how to connect to an ODBC database using the .NET Framework Data Provider for ODBC, the System.Data.Odbc. Для ConnectionString свойства задано имя источника данных ODBC (DSN), которое используется для подключения к базе данных ODBC.The ConnectionString property is set to the name of an ODBC data source name (DSN) that is used to connect to the ODBC database.

<!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 включает следующие поставщики данных:The .NET Framework includes the following data providers:

  • System.Data.SqlClient Поставщик .NET Framework поставщиком данных по умолчанию для SQL Server.The System.Data.SqlClient provider is the default .NET Framework Data Provider for SQL Server.

  • System.Data.OleDb Поставщик является .NET Framework поставщиком данных для OLE DB.The System.Data.OleDb provider is the .NET Framework Data Provider for OLE DB.

  • System.Data.Odbc Поставщик является .NET Framework поставщиком данных для ODBC.The System.Data.Odbc provider is the .NET Framework Data Provider for ODBC.

  • System.Data.OracleClient Поставщик является .NET Framework поставщиком данных для Oracle.The System.Data.OracleClient provider is the .NET Framework Data Provider for Oracle.

Свойству никогда не присваивается имя неуправляемого поставщика ADO.NET, MSDAORAнапример. ProviderNameThe ProviderName property is never set to the name of an unmanaged ADO.NET provider, such as MSDAORA. Дополнительные сведения см. в разделе Выбор данных с помощью элемента управления SqlDataSource.For more information, see Selecting Data Using the SqlDataSource Control.

При изменении ProviderName свойства DataSourceChanged вызывается событие, что приводит к повторной привязке всех элементов управления SqlDataSource , привязанных к объекту.If you change the ProviderName property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

Список доступных поставщиков указывается в DbProviderFactories подразделе system.data раздела файла Machine. config.A list of available providers is specified in the DbProviderFactories subsection of the system.data section of the Machine.config file.

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

Дополнительно