SqlDataSource.ProviderName Eigenschaft

Definition

Ruft den Namen des .NET Framework-Datenanbieters ab, mit dem das SqlDataSource-Steuerelement eine Bindung zu einer zugrunde liegenden Datenquelle herstellt, oder legt diesen Namen fest.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

Eigenschaftswert

Der Name des von der SqlDataSource verwendeten Datenanbieters, andernfalls der ADO.NET-Anbieter für Microsoft SQL Server (wenn kein Anbieter festgelegt wurde).The name of the data provider that the SqlDataSource uses; otherwise, the ADO.NET provider for Microsoft SQL Server, if no provider is set. Standardmäßig wird der ADO.NET-Anbieter für Microsoft SQL Server verwendet.The default is the ADO.NET provider for Microsoft SQL Server.

Attribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Der erste Code veranschaulicht, wie eine Verbindung mit einer SQL Server-Datenbank mithilfe der Standard .NET Framework Datenanbieter für SQL Server SqlDataSource für das- System.Data.SqlClientSteuerelement, der hergestellt wird.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. Im zweiten Codebeispiel wird veranschaulicht, wie eine Verbindung mit einer ODBC-Datenbank mithilfe der .NET Framework Datenanbieter für ODBC, dem System.Data.Odbchergestellt wird.The second code example demonstrates how to connect to an ODBC database using the .NET Framework Data Provider for ODBC, the System.Data.Odbc.

Im folgenden Codebeispiel SqlDataSource System.Data.SqlClientwird veranschaulicht, wie mit dem Standarddaten Anbieter für das-Steuerelement eine Verbindung mit einer SQL Server-Datenbank hergestellt wird.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. Wenn die ProviderName Eigenschaft nicht explizit festgelegt wird, wird der Standardanbieter verwendet.Whenever the ProviderName property is not explicitly set, the default provider is used. Die ConnectionString -Eigenschaft ist Anbieter spezifisch.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>

Das folgende Codebeispiel, das funktionell identisch mit dem vorangehenden Codebeispiel ist, veranschaulicht das Herstellen einer Verbindung mit einer ODBC-Datenbank mithilfe der .NET Framework Datenanbieter für ODBC System.Data.Odbc, der.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. Die ConnectionString -Eigenschaft wird auf den Namen eines ODBC-Datenquellen namens (DSN) festgelegt, der verwendet wird, um eine Verbindung mit der ODBC-Datenbank herzustellen.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>

Hinweise

Die .NET Framework umfasst die folgenden Datenanbieter:The .NET Framework includes the following data providers:

Die ProviderName -Eigenschaft wird nie auf den Namen eines nicht verwalteten ADO.NET-Anbieters festgelegt, MSDAORAz. b.The ProviderName property is never set to the name of an unmanaged ADO.NET provider, such as MSDAORA. Weitere Informationen finden Sie unter Auswählen von Daten mit dem SqlDataSource-SteuerElement.For more information, see Selecting Data Using the SqlDataSource Control.

Wenn Sie die ProviderName -Eigenschaft ändern, DataSourceChanged wird das-Ereignis ausgelöst und bewirkt, SqlDataSource dass alle Steuerelemente, die an gebunden sind, erneut gebunden werden.If you change the ProviderName property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

Eine Liste der verfügbaren Anbieter wird im DbProviderFactories -unter Abschnitt system.data des-Abschnitts der Datei "Machine. config" angegeben.A list of available providers is specified in the DbProviderFactories subsection of the system.data section of the Machine.config file.

Gilt für:

Siehe auch