SqlDataSource.ProviderName Vlastnost

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á; jinak ADO.NET zprostředkovatele microsoft SQL Serveru, pokud není nastavený žádný zprostředkovatel. Výchozí hodnotou 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 ODBC, rozhraní 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, the System.Data.SqlClient. ProviderName Pokud vlastnost není explicitně nastavená, 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 předchozí příklad kódu, ukazuje, jak se připojit k databázi ODBC pomocí zprostředkovatele dat rozhraní .NET Framework pro 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:

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

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

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

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

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?