SqlDataAdapter Constructores

Referencia

Definición

Espacio de nombres:: Microsoft.Data.SqlClient

Ensamblado:: Microsoft.Data.SqlClient.dll

Paquete:: Microsoft.Data.SqlClient v1.0.19269.1

Paquete:: Microsoft.Data.SqlClient v1.1.4

Paquete:: Microsoft.Data.SqlClient v2.0.1

Paquete:: Microsoft.Data.SqlClient v2.1.4

Paquete:: Microsoft.Data.SqlClient v3.0.1

Paquete:: Microsoft.Data.SqlClient v3.1.0

Paquete:: Microsoft.Data.SqlClient v4.0.1

Paquete:: Microsoft.Data.SqlClient v4.1.0

Paquete:: Microsoft.Data.SqlClient v5.0.0

Paquete:: Microsoft.Data.SqlClient v5.1.0

Paquete:: Microsoft.Data.SqlClient v5.2.0

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

SqlDataAdapter()	Inicializa una nueva instancia de la clase SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Inicializa una nueva instancia de la clase SqlDataAdapter con el objeto SqlCommand especificado como propiedad SelectCommand.
SqlDataAdapter(String, SqlConnection)	Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y un objeto SqlConnection.
SqlDataAdapter(String, String)	Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y una cadena de conexión.

SqlDataAdapter()

Inicializa una nueva instancia de la clase SqlDataAdapter.

public:
 SqlDataAdapter();

public SqlDataAdapter ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea un SqlDataAdapter objeto y se establecen algunas de sus propiedades.

public static SqlDataAdapter CreateSqlDataAdapter(SqlConnection connection)
{
    // Assumes that connection is a valid SqlConnection object
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the commands.
    adapter.SelectCommand = new SqlCommand(
        "SELECT CustomerID, CompanyName FROM CUSTOMERS", connection);
    adapter.InsertCommand = new SqlCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (@CustomerID, @CompanyName)", connection);
    adapter.UpdateCommand = new SqlCommand(
        "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
        "WHERE CustomerID = @oldCustomerID", connection);
    adapter.DeleteCommand = new SqlCommand(
        "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        SqlDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        SqlDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        SqlDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        SqlDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Comentarios

Cuando se crea una instancia de , las siguientes propiedades de SqlDataAdapter lectura y escritura se establecen en los siguientes valores iniciales.

Propiedades	Valor inicial
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Se aplica a

SqlDataAdapter(SqlCommand)

Inicializa una nueva instancia de la clase SqlDataAdapter con el objeto SqlCommand especificado como propiedad SelectCommand.

public:
 SqlDataAdapter(Microsoft::Data::SqlClient::SqlCommand ^ selectCommand);

public SqlDataAdapter (Microsoft.Data.SqlClient.SqlCommand selectCommand);

new Microsoft.Data.SqlClient.SqlDataAdapter : Microsoft.Data.SqlClient.SqlCommand -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommand As SqlCommand)

Parámetros

selectCommand: SqlCommand

SqlCommand que es un procedimiento almacenado o una instrucción SELECT de Transact-SQL que se establece como la propiedad SelectCommand de SqlDataAdapter.

Ejemplos

En el ejemplo siguiente se crea un SqlDataAdapter objeto y se establecen algunas de sus propiedades.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(SqlCommand selectCommand,
        SqlConnection connection)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(selectCommand);
        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

        // Create the other commands.
        adapter.InsertCommand = new SqlCommand(
            "INSERT INTO Customers (CustomerID, CompanyName) " +
            "VALUES (@CustomerID, @CompanyName)", connection);

        adapter.UpdateCommand = new SqlCommand(
            "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
            "WHERE CustomerID = @oldCustomerID", connection);

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Comentarios

Esta implementación del SqlDataAdapter constructor establece la SelectCommand propiedad en el valor especificado en el selectCommand parámetro .

Cuando se crea una instancia de , las siguientes propiedades de SqlDataAdapter lectura y escritura se establecen en los siguientes valores iniciales.

Propiedades	Valor inicial
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Cuando SelectCommand (o cualquiera de las demás propiedades de comando) se asigna a un objeto creado SqlCommandanteriormente, no SqlCommand se clona. SelectCommand mantiene una referencia al objeto creado SqlCommand anteriormente.

Se aplica a

SqlDataAdapter(String, SqlConnection)

Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y un objeto SqlConnection.

public:
 SqlDataAdapter(System::String ^ selectCommandText, Microsoft::Data::SqlClient::SqlConnection ^ selectConnection);

public SqlDataAdapter (string selectCommandText, Microsoft.Data.SqlClient.SqlConnection selectConnection);

new Microsoft.Data.SqlClient.SqlDataAdapter : string * Microsoft.Data.SqlClient.SqlConnection -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommandText As String, selectConnection As SqlConnection)

Parámetros

selectCommandText: String

String que es un procedimiento almacenado o una instrucción SELECT de Transact-SQL y que será utilizado por la propiedad SelectCommand de SqlDataAdapter.

selectConnection: SqlConnection

SqlConnection que representa la conexión. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlCredential para pasar el Id. de usuario y la contraseña de forma más segura que especificando el identificador de usuario y la contraseña como texto en la cadena de conexión.

Ejemplos

En el ejemplo siguiente se crea un SqlDataAdapter objeto y se establecen algunas de sus propiedades.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
        SqlConnection connection)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(commandText, connection);

        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

        // Create the other commands.
        adapter.InsertCommand = new SqlCommand(
            "INSERT INTO Customers (CustomerID, CompanyName) " +
            "VALUES (@CustomerID, @CompanyName)");

        adapter.UpdateCommand = new SqlCommand(
            "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
            "WHERE CustomerID = @oldCustomerID");

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID");

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Comentarios

Esta implementación de SqlDataAdapter se abre y cierra si SqlConnection aún no está abierta. Esto puede ser útil en una aplicación que debe llamar al Fill método para dos o más SqlDataAdapter objetos. Si el objeto SqlConnection ya está abierto, debe llamar explícitamente a Close o Dispose para cerrarlo.

Cuando se crea una instancia de , las siguientes propiedades de SqlDataAdapter lectura y escritura se establecen en los siguientes valores iniciales.

Propiedades	Valor inicial
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Se aplica a

SqlDataAdapter(String, String)

Inicializa una nueva instancia de la clase SqlDataAdapter con una propiedad SelectCommand y una cadena de conexión.

public:
 SqlDataAdapter(System::String ^ selectCommandText, System::String ^ selectConnectionString);

public SqlDataAdapter (string selectCommandText, string selectConnectionString);

new Microsoft.Data.SqlClient.SqlDataAdapter : string * string -> Microsoft.Data.SqlClient.SqlDataAdapter

Public Sub New (selectCommandText As String, selectConnectionString As String)

Parámetros

selectCommandText: String

String que es un procedimiento almacenado o una instrucción SELECT de Transact-SQL y que será utilizado por la propiedad SelectCommand de SqlDataAdapter.

selectConnectionString: String

La cadena de conexión. Si la cadena de conexión no usa Integrated Security = true, puede usar SqlDataAdapter(String, SqlConnection) y SqlCredential para pasar el identificador de usuario y la contraseña de forma más segura que si especifica el identificador de usuario y la contraseña como texto en la cadena de conexión.

Ejemplos

En el ejemplo siguiente se crea un SqlDataAdapter objeto y se establecen algunas de sus propiedades.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
        string connectionString)
    {
        SqlDataAdapter adapter = new SqlDataAdapter(commandText, connectionString);
        SqlConnection connection = adapter.SelectCommand.Connection;

        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

        // Create the commands.
        adapter.InsertCommand = new SqlCommand(
            "INSERT INTO Customers (CustomerID, CompanyName) " +
            "VALUES (@CustomerID, @CompanyName)", connection);

        adapter.UpdateCommand = new SqlCommand(
            "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
            "WHERE CustomerID = @oldCustomerID", connection);

        adapter.DeleteCommand = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

        // Create the parameters.
        adapter.InsertCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.InsertCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");

        adapter.UpdateCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID");
        adapter.UpdateCommand.Parameters.Add("@CompanyName",
            SqlDbType.VarChar, 40, "CompanyName");
        adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand.Parameters.Add("@CustomerID",
            SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;

        return adapter;
    }
}

Comentarios

Esta sobrecarga del SqlDataAdapter constructor usa el selectCommandText parámetro para establecer la SelectCommand propiedad . SqlDataAdapter creará y mantendrá la conexión creada con el selectConnectionString parámetro .

Cuando se crea una instancia de , las siguientes propiedades de SqlDataAdapter lectura y escritura se establecen en los siguientes valores iniciales.

Propiedades	Valor inicial
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Puede cambiar el valor de cualquiera de estas propiedades a través de una llamada independiente a la propiedad .

Se aplica a

Compartir a través de

SqlDataAdapter Constructores

Definición

Sobrecargas

SqlDataAdapter()

Ejemplos

Comentarios

Se aplica a

SqlDataAdapter(SqlCommand)

Parámetros

Ejemplos

Comentarios

Se aplica a

SqlDataAdapter(String, SqlConnection)

Parámetros

Ejemplos

Comentarios

Se aplica a

SqlDataAdapter(String, String)

Parámetros

Ejemplos

Comentarios

Se aplica a

Recursos adicionales