SqlDataSource.ProviderName Eigenschap

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee haalt u de naam op van de .NET Framework-gegevensprovider die door het besturingselement SqlDataSource wordt gebruikt om verbinding te maken met een onderliggende gegevensbron.

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

Waarde van eigenschap

String

De naam van de gegevensprovider die de SqlDataSource gebruikt; anders wordt de ADO.NET-provider voor Microsoft SQL Server ingesteld als er geen provider is ingesteld. De standaardwaarde is de ADO.NET-provider voor Microsoft SQL Server.

Kenmerken: TypeConverterAttribute

Voorbeelden

Deze sectie bevat twee codevoorbeelden. De eerste code laat zien hoe u verbinding maakt met een SQL Server-database met behulp van de standaard-.NET Framework-Data Provider voor SQL Server voor het besturingselement SqlDataSource, de System.Data.SqlClient. Het tweede codevoorbeeld laat zien hoe u verbinding maakt met een ODBC-database met behulp van de .NET Framework-Data Provider voor ODBC, de System.Data.Odbc.

In het volgende codevoorbeeld ziet u hoe u verbinding maakt met een SQL Server-database met behulp van de standaardgegevensprovider voor het besturingselement SqlDataSource, de System.Data.SqlClient. Wanneer de ProviderName eigenschap niet expliciet is ingesteld, wordt de standaardprovider gebruikt. De ConnectionString eigenschap is providerspecifiek.

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

Het volgende codevoorbeeld, dat functioneel hetzelfde is als het voorgaande codevoorbeeld, laat zien hoe u verbinding maakt met een ODBC-database met behulp van het .NET Framework Data Provider voor ODBC, de System.Data.Odbc. De ConnectionString eigenschap is ingesteld op de naam van een ODBC-gegevensbronnaam (DSN) die wordt gebruikt om verbinding te maken met de 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>

Opmerkingen

Het .NET Framework bevat de volgende gegevensproviders:

De System.Data.SqlClient-provider is de standaard-.NET Framework-Data Provider voor SQL Server.
De provider System.Data.OleDb is de .NET Framework-Data Provider voor OLE DB.
De System.Data.Odbc-provider is de .NET Framework-Data Provider voor ODBC.
De System.Data.OracleClient-provider is de .NET Framework-Data Provider voor Oracle.

De eigenschap ProviderName wordt nooit ingesteld op de naam van een niet-beheerde ADO.NET provider, zoals MSDAORA. Zie Gegevens selecteren met behulp van het besturingselement SqlDataSource voor meer informatie.

Als u de ProviderName eigenschap wijzigt, wordt de DataSourceChanged gebeurtenis gegenereerd, waardoor besturingselementen die aan de SqlDataSource eigenschap zijn gebonden, opnieuw worden gekoppeld.

Er wordt een lijst met beschikbare providers opgegeven in de DbProviderFactories subsectie van de system.data sectie van het Machine.config-bestand.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?