Compartir vía

SqlDataSource.ConnectionString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la cadena de conexión específica del proveedor ADO.NET que usa el control SqlDataSource para conectarse a una base de datos subyacente.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public virtual string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overridable Property ConnectionString As String

Valor de propiedad

String

Cadena específica del proveedor de datos de .NET Framework que usa el SqlDataSource para conectarse a la base de datos SQL que representa. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la propiedad ConnectionString para conectarse a una base de datos de SQL Server y mostrar los resultados de la propiedad SelectCommand en un control GridView.

<%@ 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 FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </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 FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Comentarios

El control SqlDataSource se puede usar con una variedad de proveedores de ADO.NET y la sintaxis de la cadena de conexión que se usa para conectarse a un origen de datos subyacente es específica del proveedor.

Al configurar un control SqlDataSource, establezca la propiedad ProviderName en el tipo de base de datos (el valor predeterminado es System.Data.SqlClient) y establezca la propiedad ConnectionString en una cadena de conexión que incluya información necesaria para conectarse a la base de datos. El contenido de una cadena de conexión difiere en función del tipo de base de datos al que accede el control de origen de datos. Por ejemplo, el control SqlDataSource requiere un nombre de servidor, un nombre de base de datos (catálogo) e información sobre cómo autenticar al usuario al conectarse a sql Server. Para obtener información sobre el contenido de las cadenas de conexión, vea la propiedad ConnectionString para la clase SqlConnection, ConnectionString propiedad para la clase OracleConnection, ConnectionString propiedad para la clase OleDbConnection o la propiedad ConnectionString para la clase OdbcConnection.

Si cambia la propiedad ConnectionString, se genera el evento DataSourceChanged, lo que provoca que los controles enlazados al control SqlDataSource se vuelvan a enlazar.

Importante

Para obtener información sobre cómo almacenar una cadena de conexión, vea How To: Secure Connection Strings when Using Data Source Controls.

Se aplica a

Consulte también