SqlDataSource.ProviderName Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název zprostředkovatele dat rozhraní .NET Framework, který SqlDataSource ovládací prvek používá pro připojení k podkladovému zdroji dat.

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

Hodnota vlastnosti

String

Název zprostředkovatele dat, který SqlDataSource používá. V opačném případě se jedná o ADO.NET zprostředkovatele pro Microsoft SQL Server, pokud není nastaven žádný zprostředkovatel. Výchozí je poskytovatel ADO.NET pro Microsoft SQL Server.

Atributy: TypeConverterAttribute

Příklady

Tato část obsahuje dva příklady kódu. První kód ukazuje, jak se připojit k databázi SQL Serveru pomocí výchozího zprostředkovatele dat rozhraní .NET Framework pro SQL Server pro SqlDataSource ovládací prvek System.Data.SqlClient. Druhý příklad kódu ukazuje, jak se připojit k databázi ODBC pomocí zprostředkovatele dat rozhraní .NET Framework pro rozhraní ODBC .System.Data.Odbc

Následující příklad kódu ukazuje, jak se připojit k databázi SQL Serveru pomocí výchozího zprostředkovatele dat pro SqlDataSource ovládací prvek System.Data.SqlClient. ProviderName Kdykoli není vlastnost explicitně nastavena, použije se výchozí zprostředkovatel. Vlastnost ConnectionString je specifická pro poskytovatele.

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

Následující příklad kódu, který je funkčně stejný jako v předchozím příkladu kódu, ukazuje, jak se připojit k databázi ODBC pomocí zprostředkovatele dat rozhraní .NET Framework pro ROZHRANÍ ODBC, System.Data.Odbc. Vlastnost ConnectionString je nastavena na název zdroje dat ODBC (DSN), který se používá pro připojení k databázi ODBC.

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

Poznámky

Rozhraní .NET Framework obsahuje následující zprostředkovatele dat:

Zprostředkovatel System.Data.SqlClient je výchozí zprostředkovatel dat rozhraní .NET Framework pro SQL Server.
Zprostředkovatel System.Data.OleDb je zprostředkovatel dat rozhraní .NET Framework pro OLE DB.
Zprostředkovatel System.Data.Odbc je zprostředkovatel dat rozhraní .NET Framework pro rozhraní ODBC.
Zprostředkovatel System.Data.OracleClient je zprostředkovatel dat rozhraní .NET Framework pro Oracle.

Vlastnost ProviderName není nikdy nastavena na název nespravovaného poskytovatele ADO.NET, například MSDAORA. Další informace najdete v tématu Výběr dat pomocí ovládacího prvku SqlDataSource.

Pokud změníte ProviderName vlastnost, DataSourceChanged událost je vyvolána, což způsobí, že všechny ovládací prvky, které jsou vázány SqlDataSource na znovu vazby.

Seznam dostupných poskytovatelů je uveden v DbProviderFactories pododdílu oddílu system.data Machine.config souboru.

Platí pro

Sdílet prostřednictvím