SqlDataSource.ProviderName Egenskap

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar eller anger namnet på .NET Framework-dataprovidern som SqlDataSource-kontrollen använder för att ansluta till en underliggande datakälla.

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

Egenskapsvärde

String

Namnet på dataprovidern som SqlDataSource använder. annars har ADO.NET-providern för Microsoft SQL Server, om ingen provider har angetts. Standardvärdet är ADO.NET-providern för Microsoft SQL Server.

Attribut: TypeConverterAttribute

Exempel

Det här avsnittet innehåller två kodexempel. Den första koden visar hur du ansluter till en SQL Server databas med standardvärdet .NET Framework Data Provider för SQL Server för kontrollen SqlDataSource, System.Data.SqlClient. Det andra kodexemplet visar hur du ansluter till en ODBC-databas med hjälp av .NET Framework-Data Provider för ODBC, System.Data.Odbc.

I följande kodexempel visas hur du ansluter till en SQL Server databas med hjälp av standarddataprovidern för SqlDataSource-kontrollen, System.Data.SqlClient. När egenskapen inte uttryckligen ProviderName anges används standardprovidern. Egenskapen ConnectionString är providerspecifik.

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

Följande kodexempel, som fungerar på samma sätt som föregående kodexempel, visar hur du ansluter till en ODBC-databas med hjälp av .NET Framework-Data Provider för ODBC, System.Data.Odbc. Egenskapen ConnectionString är inställd på namnet på ett ODBC-datakällnamn (DSN) som används för att ansluta till ODBC-databasen.

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

Kommentarer

.NET Framework innehåller följande dataproviders:

Providern System.Data.SqlClient är standardprovidern .NET Framework Data Provider för SQL Server.
Providern System.Data.OleDb är .NET Framework-Data Provider för OLE DB.
Providern System.Data.Odbc är .NET Framework-Data Provider för ODBC.
Providern System.Data.OracleClient är .NET Framework-Data Provider för Oracle.

Egenskapen ProviderName anges aldrig till namnet på en ohanterad ADO.NET provider, till exempel MSDAORA. Mer information finns i Välja data med hjälp av SqlDataSource-kontrollen.

Om du ändrar ProviderName egenskapen DataSourceChanged aktiveras händelsen, vilket gör att alla kontroller som är bundna till bindningen SqlDataSource ombinds.

En lista över tillgängliga leverantörer anges i DbProviderFactories underavsnittet i system.data avsnittet i filen Machine.config.

Gäller för

Se även

ConnectionString
Webbserverkontroller för datakälla
Översikt över SqlDataSource-webbserverkontroll
översikt över ASP.NET sidlivscykel

Feedback

Var den här sidan till hjälp?