SqlDataAdapter Construtores

Referência

Definição

Namespace:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Pacote:: Microsoft.Data.SqlClient v1.0.19269.1

Pacote:: Microsoft.Data.SqlClient v1.1.4

Pacote:: Microsoft.Data.SqlClient v2.0.1

Pacote:: Microsoft.Data.SqlClient v2.1.4

Pacote:: Microsoft.Data.SqlClient v3.0.1

Pacote:: Microsoft.Data.SqlClient v3.1.0

Pacote:: Microsoft.Data.SqlClient v4.0.1

Pacote:: Microsoft.Data.SqlClient v4.1.0

Pacote:: Microsoft.Data.SqlClient v5.0.0

Pacote:: Microsoft.Data.SqlClient v5.1.0

Pacote:: Microsoft.Data.SqlClient v5.2.0

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

SqlDataAdapter()	Inicializa uma nova instância da classe SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Inicializa uma nova instância da classe SqlDataAdapter com o SqlCommand especificado como a propriedade SelectCommand.
SqlDataAdapter(String, SqlConnection)	Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e um objeto SqlConnection.
SqlDataAdapter(String, String)	Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e uma cadeia de conexão.

SqlDataAdapter()

Inicializa uma nova instância da classe SqlDataAdapter.

public:
 SqlDataAdapter();

public SqlDataAdapter ();

Public Sub New ()

Exemplos

O exemplo a seguir cria um SqlDataAdapter e define algumas de suas propriedades.

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;
}

Comentários

Quando uma instância de SqlDataAdapter é criada, as propriedades de leitura/gravação a seguir são definidas com os seguintes valores iniciais.

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

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Aplica-se a

SqlDataAdapter(SqlCommand)

Inicializa uma nova instância da classe SqlDataAdapter com o SqlCommand especificado como a propriedade 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

Um SqlCommand que é uma instrução SELECT Transact-SQL ou um procedimento armazenado e é definido como a propriedade SelectCommand do SqlDataAdapter.

Exemplos

O exemplo a seguir cria um SqlDataAdapter e define algumas de suas propriedades.

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;
    }
}

Comentários

Essa implementação do SqlDataAdapter construtor define a SelectCommand propriedade como o valor especificado no selectCommand parâmetro .

Quando uma instância de SqlDataAdapter é criada, as propriedades de leitura/gravação a seguir são definidas com os seguintes valores iniciais.

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

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Quando SelectCommand (ou qualquer uma das outras propriedades de comando) é atribuída a um criado SqlCommandanteriormente, o SqlCommand não é clonado. O SelectCommand mantém uma referência ao objeto criado SqlCommand anteriormente.

Aplica-se a

SqlDataAdapter(String, SqlConnection)

Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e um 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

Um String que é uma instrução SELECT Transact-SQL ou um procedimento armazenado a ser usado pela propriedade SelectCommand do SqlDataAdapter.

selectConnection: SqlConnection

Um SqlConnection que representa a conexão. Se a cadeia de conexão não usar Integrated Security = true, você poderá usar SqlCredential para passar a ID de usuário e a senha com mais segurança do que especificando a ID de usuário e a senha como texto na cadeia de conexão.

Exemplos

O exemplo a seguir cria um SqlDataAdapter e define algumas de suas propriedades.

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;
    }
}

Comentários

Esta implementação do SqlDataAdapter abre e fecha um SqlConnection se ainda não estiver aberto. Isso pode ser útil em um aplicativo que deve chamar o Fill método para dois ou mais SqlDataAdapter objetos. Se o SqlConnection é estiver aberto, você deve chamar explicitamente feche ou Dispose para fechá-la.

Quando uma instância de SqlDataAdapter é criada, as propriedades de leitura/gravação a seguir são definidas com os seguintes valores iniciais.

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

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Aplica-se a

SqlDataAdapter(String, String)

Inicializa uma nova instância da classe SqlDataAdapter com um SelectCommand e uma cadeia de conexão.

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

Um String que é uma instrução SELECT Transact-SQL ou um procedimento armazenado a ser usado pela propriedade SelectCommand do SqlDataAdapter.

selectConnectionString: String

A cadeia de conexão. Se a cadeia de conexão não usar Integrated Security = true, você poderá usar SqlDataAdapter(String, SqlConnection) e SqlCredential para passar a ID de usuário e a senha com mais segurança do que especificando a ID de usuário e a senha como texto na cadeia de conexão.

Exemplos

O exemplo a seguir cria um SqlDataAdapter e define algumas de suas propriedades.

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;
    }
}

Comentários

Essa sobrecarga do SqlDataAdapter construtor usa o selectCommandText parâmetro para definir a SelectCommand propriedade . O SqlDataAdapter criará e manterá a conexão criada com o selectConnectionString parâmetro .

Quando uma instância de SqlDataAdapter é criada, as propriedades de leitura/gravação a seguir são definidas com os seguintes valores iniciais.

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

Você pode alterar o valor de qualquer uma dessas propriedades por meio de uma chamada separada para a propriedade .

Aplica-se a

Compartilhar via

SqlDataAdapter Construtores

Definição

Sobrecargas

SqlDataAdapter()

Exemplos

Comentários

Aplica-se a

SqlDataAdapter(SqlCommand)

Parâmetros

Exemplos

Comentários

Aplica-se a

SqlDataAdapter(String, SqlConnection)

Parâmetros

Exemplos

Comentários

Aplica-se a

SqlDataAdapter(String, String)

Parâmetros

Exemplos

Comentários

Aplica-se a

Recursos adicionais