Share via

SqlDataSource.ProviderName Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin temel alınan bir veri kaynağına bağlanmak için kullandığı .NET Framework veri sağlayıcısının SqlDataSource adını alır veya ayarlar.

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

Özellik Değeri

String

Kullanan veri sağlayıcısının SqlDataSource adı; aksi takdirde, hiçbir sağlayıcı ayarlanmadıysa Microsoft SQL Server için ADO.NET sağlayıcısı. Varsayılan değer, Microsoft SQL Server için ADO.NET sağlayıcısıdır.

Öznitelikler
TypeConverterAttribute

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod, denetimi için SQL Server için varsayılan .NET Framework Veri Sağlayıcısını kullanarak bir SQL Server veritabanına bağlanmayı SqlDataSourceSystem.Data.SqlClientgösterir. İkinci kod örneği, ODBC için .NET Framework Veri Sağlayıcısını kullanarak bir ODBC veritabanına bağlanmayı System.Data.Odbcgösterir.

Aşağıdaki kod örneği, denetimi için SqlDataSource varsayılan veri sağlayıcısı olan kullanarak bir SQL Server veritabanına nasıl bağlanacaklarını System.Data.SqlClientgösterir. ProviderName Özellik açıkça ayarlanmadığı her durumda varsayılan sağlayıcı kullanılır. ConnectionString özelliği sağlayıcıya özgüdür.

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

Yukarıdaki kod örneğiyle işlevsel olarak aynı olan aşağıdaki kod örneği, ODBC için .NET Framework Veri Sağlayıcısı'nı kullanarak bir ODBC veritabanına bağlanmayı System.Data.Odbcgösterir. ConnectionString özelliği, ODBC veritabanına bağlanmak için kullanılan bir ODBC veri kaynağı adının (DSN) adına ayarlanır.

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

Açıklamalar

.NET Framework aşağıdaki veri sağlayıcılarını içerir:

ProviderName özelliği hiçbir zaman gibi MSDAORAyönetilmeyen bir ADO.NET sağlayıcısının adına ayarlanmamıştır. Daha fazla bilgi için bkz. SqlDataSource Denetimini Kullanarak Veri Seçme.

özelliğini değiştirirseniz ProviderName olayı DataSourceChanged tetiklenir ve öğesine bağlı SqlDataSource tüm denetimlerin yeniden bağlanmasına neden olur.

Kullanılabilir sağlayıcıların listesi, Machine.config dosyasının system.data bölümünün alt bölümünde belirtilirDbProviderFactories.

Şunlara uygulanır

Ayrıca bkz.