Compartir a través de

SqlDataSource Constructores

  • Referencia

Definición

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

Inicializa una nueva instancia de la clase SqlDataSource.

Sobrecargas

SqlDataSource()

Inicializa una nueva instancia de la clase SqlDataSource.
SqlDataSource(String, String)

Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select.
SqlDataSource(String, String, String)

Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select.

SqlDataSource()

Inicializa una nueva instancia de la clase SqlDataSource.

public:
 SqlDataSource();
public SqlDataSource ();
Public Sub New ()

Consulte también

Se aplica a

SqlDataSource(String, String)

Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select.

public:
 SqlDataSource(System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (connectionString As String, selectCommand As String)

Parámetros

connectionString
String

La cadena de conexión que se utiliza para conectarse a la base de datos subyacente.

selectCommand
String

La consulta SQL utilizada para recuperar datos de la base de datos subyacente. Si la consulta SQL es una cadena SQL parametrizada, quizá necesite agregar objetos Parameter a la colección SelectParameters.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un SqlDataSource control mediante el SqlDataSource constructor . El ejemplo es inusual en que el SqlDataSource control se usa no en una página de Formularios Web Forms, sino en la implementación de un objeto de nivel intermedio como una manera sencilla de que un objeto empresarial interactúe con una base de datos. En el ejemplo se usa una cadena de conexión que se almacena en el archivo Web.config.

Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase ObjectDataSource.

// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
  ArrayList al = new ArrayList();

  ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

  SqlDataSource sds
    = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

  try {

    IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

    // Iterate through the Enumeration and create a
    // NorthwindEmployee object for each ID.
    foreach (DataRowView row in IDs) {
      string id = row["EmployeeID"].ToString();
      NorthwindEmployee nwe = new NorthwindEmployee(id);
      // Add the NorthwindEmployee object to the collection.
      al.Add(nwe);
    }
  }
  finally {
    // If anything strange happens, clean up.
    sds.Dispose();
  }

  return al;
}

' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
   Dim al As New ArrayList()

   Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
   Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
   Try
      Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

      ' Iterate through the Enumeration and create a
      ' NorthwindEmployee object for each ID.
      For Each row As DataRowView In IDs
         Dim id As String = row("EmployeeID").ToString()
         Dim nwe As New NorthwindEmployee(id)
         ' Add the NorthwindEmployee object to the collection.
         al.Add(nwe)
      Next
   Finally
      ' If anything strange happens, clean up.
      sds.Dispose()
   End Try

   Return al
End Function 'GetAllEmployees

Comentarios

Dado que diferentes productos de base de datos usan diferentes variedades de SQL, la sintaxis de selectCommand depende del proveedor de ADO.NET actual que se usa, que se identifica mediante la ProviderName propiedad . Si la cadena de SQL es un comando o consulta parametrizado, el marcador de posición del parámetro también depende del proveedor de ADO.NET que se está usando. Por ejemplo, si el proveedor es System.Data.SqlClient, que es el proveedor predeterminado para la SqlDataSource clase , el marcador de posición del parámetro es '@parameterName'. Sin embargo, si el proveedor se establece System.Data.Odbc en o System.Data.OleDb, el marcador de posición del parámetro es '?'. Para obtener más información sobre las consultas y comandos SQL con parámetros, vea Usar parámetros con el control SqlDataSource.

El SelectCommand valor puede ser una cadena SQL o el nombre de un procedimiento almacenado, si el origen de datos admite procedimientos almacenados.

Consulte también

Se aplica a

SqlDataSource(String, String, String)

Inicializa una nueva instancia de la clase SqlDataSource con la cadena de conexión especificada y el comando Select.

public:
 SqlDataSource(System::String ^ providerName, System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource (string providerName, string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (providerName As String, connectionString As String, selectCommand As String)

Parámetros

providerName
String

El nombre del proveedor de datos que utiliza el objeto SqlDataSource. Si no se establece ningún proveedor, el control SqlDataSource utiliza el proveedor ADO.NET para Microsoft SQL Server, de manera predeterminada.

connectionString
String

La cadena de conexión que se utiliza para conectarse a la base de datos subyacente.

selectCommand
String

La consulta SQL utilizada para recuperar datos de la base de datos subyacente. Si la consulta SQL es una cadena SQL parametrizada, quizá necesite agregar objetos Parameter a la colección SelectParameters.

Comentarios

Dado que los distintos productos de base de datos usan diferentes variedades de SQL, la sintaxis de selectCommand depende del proveedor de ADO.NET actual que se usa, que se identifica mediante el providerName parámetro . Si la cadena de SQL es un comando o consulta parametrizado, el marcador de posición del parámetro también depende del proveedor de ADO.NET que se está usando. Por ejemplo, si el proveedor es System.Data.SqlClient, que es el proveedor predeterminado para la SqlDataSource clase , el marcador de posición del parámetro es '@parameterName'. Sin embargo, si el proveedor se establece System.Data.Odbc en o System.Data.OleDb, el marcador de posición del parámetro es '?'. Para obtener más información sobre las consultas y comandos SQL con parámetros, vea Usar parámetros con el control SqlDataSource.

La SelectCommand propiedad puede ser una cadena SQL o el nombre de un procedimiento almacenado, si el origen de datos admite procedimientos almacenados.

Consulte también

Se aplica a