SqlDataSource.ProviderName Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

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

Beispiele

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

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des Standarddatenanbieters für das SqlDataSource Steuerelement eine System.Data.SqlClientVerbindung mit einer SQL Server-Datenbank herstellen. 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>

Das folgende Codebeispiel, das funktional identisch mit dem vorherigen Codebeispiel ist, veranschaulicht, wie eine Verbindung mit einer ODBC-Datenbank mithilfe des .NET Framework-Datenanbieters für ODBC, dem System.Data.Odbc. 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

.NET Framework umfasst die folgenden Datenanbieter:

Der System.Data.SqlClient Anbieter ist der .NET Framework-Standarddatenanbieter für SQL Server.
Der System.Data.OleDb Anbieter ist der .NET Framework-Datenanbieter für OLE DB.
Der System.Data.Odbc Anbieter ist der .NET Framework-Datenanbieter für ODBC.
Der System.Data.OracleClient Anbieter ist der .NET Framework-Datenanbieter für Oracle.

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:

Freigeben über