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.

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

Eigenschaftswert

Der Name des von der SqlDataSource verwendeten Datenanbieters, andernfalls der ADO.NET-Anbieter für Microsoft SQL Server (wenn kein Anbieter festgelegt wurde). Standardmäßig wird der ADO.NET-Anbieter für Microsoft SQL Server verwendet.

Attribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Der erste Code veranschaulicht das Herstellen einer Verbindung mit einer SQL Server-Datenbank mithilfe des Standarddatenanbieters .NET Framework für SQL Server für das SqlDataSource Steuerelement, das System.Data.SqlClient. Im zweiten Codebeispiel wird veranschaulicht, wie Sie mithilfe des .NET Framework Datenanbieters für ODBC eine System.Data.OdbcVerbindung mit einer ODBC-Datenbank herstellen.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des Standarddatenanbieters für das SqlDataSource Steuerelement eine Verbindung mit einer SQL Server Datenbank herstellen.System.Data.SqlClient Wenn die ProviderName Eigenschaft nicht explizit festgelegt ist, wird der Standardanbieter verwendet. Die ConnectionString Eigenschaft ist anbieterspezifisch.

<%@ 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>

Im folgenden Codebeispiel, das funktional mit dem vorherigen Codebeispiel identisch ist, wird veranschaulicht, wie eine Verbindung mit einer ODBC-Datenbank mithilfe des .NET Framework-Datenanbieters für ODBC( System.Data.Odbc) hergestellt wird. Die ConnectionString -Eigenschaft ist auf den Namen eines ODBC-Datenquellennamens (DSN) festgelegt, der zum Herstellen einer Verbindung mit der ODBC-Datenbank verwendet wird.

<!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:

Die ProviderName Eigenschaft wird nie auf den Namen eines nicht verwalteten ADO.NET Anbieters festgelegt, z MSDAORA. B. . Weitere Informationen finden Sie unter Auswählen von Daten mithilfe des SqlDataSource-Steuerelements.

Wenn Sie die ProviderName -Eigenschaft ändern, wird das DataSourceChanged -Ereignis ausgelöst, wodurch alle Steuerelemente, die an die SqlDataSource gebunden sind, neu gebunden werden.

Eine Liste der verfügbaren Anbieter wird im DbProviderFactories Unterabschnitt des Abschnitts der system.data Machine.config-Datei angegeben.

Gilt für:

Weitere Informationen