SqlDataSource.ProviderName Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia nazwę dostawcy danych .NET Framework, którego SqlDataSource kontrolka używa do nawiązywania połączenia z bazowym źródłem danych.

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

Wartość właściwości

String

Nazwa dostawcy danych używanego SqlDataSource przez dostawcę, w przeciwnym razie dostawca ADO.NET dla programu Microsoft SQL Server, jeśli nie ustawiono żadnego dostawcy. Wartość domyślna to dostawca ADO.NET dla programu Microsoft SQL Server.

Atrybuty: TypeConverterAttribute

Przykłady

Ten rozdział zawiera dwa przykłady kodu. Pierwszy kod pokazuje, jak nawiązać połączenie z bazą danych programu SQL Server przy użyciu domyślnego dostawcy danych programu .NET Framework dla programu SQL Server dla kontrolki SqlDataSource System.Data.SqlClient. W drugim przykładzie kodu pokazano, jak nawiązać połączenie z bazą danych ODBC przy użyciu dostawcy danych programu .NET Framework dla ODBC.System.Data.Odbc

Poniższy przykład kodu pokazuje, jak nawiązać połączenie z bazą danych programu SQL Server przy użyciu domyślnego dostawcy danych dla kontrolki SqlDataSource .System.Data.SqlClient Zawsze, ProviderName gdy właściwość nie jest jawnie ustawiona, jest używany domyślny dostawca. Właściwość jest specyficzna ConnectionString dla dostawcy.

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

Poniższy przykład kodu, który jest funkcjonalnie taki sam jak w poprzednim przykładzie kodu, pokazuje, jak nawiązać połączenie z bazą danych ODBC przy użyciu dostawcy danych programu .NET Framework dla ODBC.System.Data.Odbc Właściwość ConnectionString jest ustawiona na nazwę nazwy źródła danych ODBC (DSN), która jest używana do nawiązywania połączenia z bazą danych 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>

Uwagi

Program .NET Framework obejmuje następujących dostawców danych:

Dostawca System.Data.SqlClient jest domyślnym dostawcą danych programu .NET Framework dla programu SQL Server.
Dostawca System.Data.OleDb jest dostawcą danych .NET Framework dla OLE DB.
Dostawca System.Data.Odbc jest dostawcą danych .NET Framework dla ODBC.
Dostawca System.Data.OracleClient jest dostawcą danych .NET Framework dla oracle.

Właściwość ProviderName nigdy nie jest ustawiona na nazwę niezarządzanego dostawcy ADO.NET, takiego jak MSDAORA. Aby uzyskać więcej informacji, zobacz Wybieranie danych przy użyciu kontrolki SqlDataSource.

Jeśli zmienisz ProviderName właściwość, DataSourceChanged zdarzenie zostanie podniesione, powodując wszystkie kontrolki powiązane z elementem do ponownego SqlDataSource powiązania.

Lista dostępnych dostawców jest określona w DbProviderFactories podsekcji system.data sekcji pliku Machine.config.

Dotyczy

Udostępnij za pośrednictwem