Share via

SqlDataSource.ProviderName Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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ého SqlDataSource používá. V opačném případě ADO.NET zprostředkovatel pro Microsoft SQL Server, pokud není žádný zprostředkovatel nastavený. Výchozí zprostředkovatel 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 Server pomocí výchozího zprostředkovatele dat rozhraní .NET Framework pro SQL Server SqlDataSource ovládacího prvku 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 Server pomocí výchozího zprostředkovatele dat pro SqlDataSource ovládací prvek System.Data.SqlClient. Kdykoli není ProviderName vlastnost explicitně nastavena, použije se výchozí zprostředkovatel. Vlastnost ConnectionString je specifická pro zprostředkovatele.

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

  • System.Data.SqlClient Zprostředkovatel je výchozím zprostředkovatelem 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 nastavená na název nespravovaného zprostředkovatele 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 k objektu SqlDataSource , se znovu zaváže.

Seznam dostupných zprostředkovatelů je uveden v DbProviderFactories části system.data souboru Machine.config.

Platí pro

Viz také