SqlDataSource.ProviderName Propiedad

Definición

Obtiene o establece el nombre del proveedor de datos de .NET Framework que utiliza el control SqlDataSource para conectar a un origen de datos subyacente.Gets or sets the name of the .NET Framework data provider that the SqlDataSource control uses to connect to an underlying data source.

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

Valor de propiedad

String

El nombre del proveedor de datos que utiliza el control SqlDataSource; de lo contrario, el proveedor de ADO.NET para Microsoft SQL Server, si no se establece ningún proveedor.The name of the data provider that the SqlDataSource uses; otherwise, the ADO.NET provider for Microsoft SQL Server, if no provider is set. El valor predeterminado es el proveedor de ADO.NET para Microsoft SQL Server.The default is the ADO.NET provider for Microsoft SQL Server.

Atributos

Ejemplos

Esta sección contiene dos ejemplos de código.This section contains two code examples. En el primer código se muestra cómo conectarse a una base de datos de SQL Server mediante el proveedor de datos .NET Framework predeterminado para SQL Server para el SqlDataSource control, System.Data.SqlClient .The first code demonstrates how to connect to a SQL Server database using the default .NET Framework Data Provider for SQL Server for the SqlDataSource control, the System.Data.SqlClient. En el segundo ejemplo de código se muestra cómo conectarse a una base de datos ODBC mediante el proveedor de datos de .NET Framework para ODBC, System.Data.Odbc .The second code example demonstrates how to connect to an ODBC database using the .NET Framework Data Provider for ODBC, the System.Data.Odbc.

En el ejemplo de código siguiente se muestra cómo conectarse a una base de datos de SQL Server mediante el proveedor de datos predeterminado para el SqlDataSource control, System.Data.SqlClient .The following code example demonstrates how to connect to a SQL Server database using the default data provider for the SqlDataSource control, the System.Data.SqlClient. Cuando la ProviderName propiedad no se establece explícitamente, se utiliza el proveedor predeterminado.Whenever the ProviderName property is not explicitly set, the default provider is used. La ConnectionString propiedad es específica del proveedor.The ConnectionString property is provider-specific.

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

En el ejemplo de código siguiente, que es funcionalmente igual que el ejemplo de código anterior, se muestra cómo conectarse a una base de datos ODBC mediante el proveedor de datos de .NET Framework para ODBC, System.Data.Odbc .The following code example, which is functionally the same as the preceding code example, demonstrates how to connect to an ODBC database using the .NET Framework Data Provider for ODBC, the System.Data.Odbc. La ConnectionString propiedad se establece en el nombre de un nombre de origen de datos ODBC (DSN) que se utiliza para conectarse a la base de datos ODBC.The ConnectionString property is set to the name of an ODBC data source name (DSN) that is used to connect to the ODBC database.

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

Comentarios

El .NET Framework incluye los siguientes proveedores de datos:The .NET Framework includes the following data providers:

La ProviderName propiedad nunca se establece en el nombre de un proveedor ADO.net no administrado, como MSDAORA .The ProviderName property is never set to the name of an unmanaged ADO.NET provider, such as MSDAORA. Para obtener más información, vea seleccionar datos mediante el control SqlDataSource.For more information, see Selecting Data Using the SqlDataSource Control.

Si cambia la ProviderName propiedad, DataSourceChanged se genera el evento, lo que provoca que los controles enlazados a se vuelvan SqlDataSource a enlazar.If you change the ProviderName property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

En la DbProviderFactories subsección de la system.data sección del archivo Machine.config se especifica una lista de proveedores disponibles.A list of available providers is specified in the DbProviderFactories subsection of the system.data section of the Machine.config file.

Se aplica a

Consulte también