SqlDataAdapter Constructeurs

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Surcharges

SqlDataAdapter()	Initialise une nouvelle instance de la classe SqlDataAdapter.
SqlDataAdapter(SqlCommand)	Initialise une nouvelle instance de la classe SqlDataAdapter avec le SqlCommand spécifié en tant que propriété SelectCommand.
SqlDataAdapter(String, SqlConnection)	Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et un objet SqlConnection.
SqlDataAdapter(String, String)	Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et une chaîne de connexion.

SqlDataAdapter()

Initialise une nouvelle instance de la classe SqlDataAdapter.

public:
 SqlDataAdapter();

public SqlDataAdapter ();

Public Sub New ()

Exemples

L’exemple suivant crée un SqlDataAdapter et définit certaines de ses propriétés.

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

Remarques

Lorsqu’une instance de SqlDataAdapter est créée, les propriétés en lecture/écriture suivantes sont définies sur les valeurs initiales suivantes.

Propriétés	Valeur initiale
MissingMappingAction	MissingMappingAction.Passthrough
MissingSchemaAction	MissingSchemaAction.Add

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.

SqlDataAdapter(SqlCommand)

Initialise une nouvelle instance de la classe SqlDataAdapter avec le SqlCommand spécifié en tant que propriété 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)

Paramètres

selectCommand

SqlCommand

SqlCommand qui est une instruction Transact-SQL SELECT ou une procédure stockée ayant valeur de propriété SelectCommand de SqlDataAdapter.

Exemples

L’exemple suivant crée un SqlDataAdapter et définit certaines de ses propriétés.

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

Remarques

Cette implémentation du SqlDataAdapter constructeur définit la SelectCommand propriété sur la valeur spécifiée dans le selectCommand paramètre .

Lorsqu’une instance de SqlDataAdapter est créée, les propriétés en lecture/écriture suivantes sont définies sur les valeurs initiales suivantes.

Propriétés	Valeur initiale
MissingMappingAction	MissingMappingAction.Passthrough
MissingSchemaAction	MissingSchemaAction.Add

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.

Lorsque SelectCommand (ou l’une des autres propriétés de commande) est affectée à un objet créé SqlCommandprécédemment , le SqlCommand n’est pas cloné. conserve SelectCommand une référence à l’objet créé précédemment SqlCommand .

SqlDataAdapter(String, SqlConnection)

Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et un objet 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)

Paramètres

selectCommandText

String

String qui est une instruction Transact-SQL SELECT ou une procédure stockée devant être utilisée par la propriété SelectCommand de SqlDataAdapter.

selectConnection

SqlConnection

SqlConnection représentant la connexion. Si votre chaîne de connexion n’utilise pas Integrated Security = true, vous pouvez utiliser SqlCredential pour transmettre l’ID utilisateur et le mot de passe d’une manière plus sécurisée qu’en spécifiant l’ID utilisateur et le mot de passe sous forme de texte dans la chaîne de connexion.

Exemples

L’exemple suivant crée un SqlDataAdapter et définit certaines de ses propriétés.

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

Remarques

Cette implémentation du SqlDataAdapter ouvre et ferme un SqlConnection s’il n’est pas déjà ouvert. Cela peut être utile dans une application qui doit appeler la Fill méthode pour deux objets ou plus SqlDataAdapter . Si le SqlConnection est déjà ouvert, vous devez appeler explicitement Fermer ou Supprimer pour le fermer.

Lorsqu’une instance de SqlDataAdapter est créée, les propriétés en lecture/écriture suivantes sont définies sur les valeurs initiales suivantes.

Propriétés	Valeur initiale
MissingMappingAction	MissingMappingAction.Passthrough
MissingSchemaAction	MissingSchemaAction.Add

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.

SqlDataAdapter(String, String)

Initialise une nouvelle instance de la classe SqlDataAdapter avec SelectCommand et une chaîne de connexion.

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)

Paramètres

selectCommandText

String

String qui est une instruction Transact-SQL SELECT ou une procédure stockée devant être utilisée par la propriété SelectCommand de SqlDataAdapter.

selectConnectionString

String

Chaîne de connexion Si votre chaîne de connexion n'utilise pas Integrated Security = true, vous pouvez utiliser la SqlDataAdapter(String, SqlConnection) et les SqlCredential pour obtenir l'ID d'utilisateur et le mot de passe de façon plus sécurisée qu'en spécifiant l'ID d'utilisateur et le mot de passe sous forme de texte dans la chaîne de connexion.

Exemples

L’exemple suivant crée un SqlDataAdapter et définit certaines de ses propriétés.

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

Remarques

Cette surcharge du SqlDataAdapter constructeur utilise le selectCommandText paramètre pour définir la SelectCommand propriété. crée SqlDataAdapter et conserve la connexion créée avec le selectConnectionString paramètre .

Lorsqu’une instance de SqlDataAdapter est créée, les propriétés en lecture/écriture suivantes sont définies sur les valeurs initiales suivantes.

Propriétés	Valeur initiale
MissingMappingAction	MissingMappingAction.Passthrough
MissingSchemaAction	MissingSchemaAction.Add

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.