SqlDataAdapter Konstruktoren

Referenz

Definition

Namespace:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

SqlDataAdapter()	Initialisiert eine neue Instanz der SqlDataAdapter-Klasse.
SqlDataAdapter(SqlCommand)	Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit dem angegebenen SqlCommand als SelectCommand-Eigenschaft.
SqlDataAdapter(String, SqlConnection)	Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit einem SelectCommand und einem SqlConnection-Objekt.
SqlDataAdapter(String, String)	Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit einem SelectCommand und einer Verbindungszeichenfolge.

SqlDataAdapter()

Initialisiert eine neue Instanz der SqlDataAdapter-Klasse.

public:
 SqlDataAdapter();

public SqlDataAdapter ();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein SqlDataAdapter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Wenn eine Instanz von SqlDataAdapter erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt.

Eigenschaften	Anfangswert
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Sie können den Wert jeder dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Gilt für:

SqlDataAdapter(SqlCommand)

Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit dem angegebenen SqlCommand als SelectCommand-Eigenschaft.

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)

Parameter

selectCommand: SqlCommand

Ein SqlCommand, der eine Transact-SQL-SELECT-Anweisung oder eine gespeicherte Prozedur darstellt und als SelectCommand-Eigenschaft des SqlDataAdapter festgelegt wurde.

Beispiele

Im folgenden Beispiel wird ein SqlDataAdapter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Diese Implementierung des SqlDataAdapter Konstruktors legt die SelectCommand -Eigenschaft auf den im selectCommand -Parameter angegebenen Wert fest.

Wenn eine Instanz von SqlDataAdapter erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt.

Eigenschaften	Anfangswert
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Sie können den Wert jeder dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Wenn SelectCommand (oder eine der anderen Befehlseigenschaften) einem zuvor erstellten SqlCommandzugewiesen wird, wird nicht SqlCommand geklont. Der SelectCommand verwaltet einen Verweis auf das zuvor erstellte SqlCommand -Objekt.

Gilt für:

SqlDataAdapter(String, SqlConnection)

Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit einem SelectCommand und einem SqlConnection-Objekt.

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)

Parameter

selectCommandText: String

Ein String, der eine Transact-SQL-SELECT-Anweisung oder eine gespeicherte Prozedur darstellt, die von der SelectCommand-Eigenschaft des SqlDataAdapter verwendet werden soll.

selectConnection: SqlConnection

Eine SqlConnection, die die Verbindung darstellt. Wenn Ihre Verbindungszeichenfolge Integrated Security = truenicht verwendet, können Sie SqlCredential verwenden, um die Benutzer-ID und das Kennwort sicherer zu übergeben als durch die Angabe von Benutzer-ID und Kennwort als Text in der Verbindungszeichenfolge.

Beispiele

Im folgenden Beispiel wird ein SqlDataAdapter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Diese Implementierung von SqlDataAdapter öffnet und schließt eine SqlConnection , wenn sie noch nicht geöffnet ist. Dies kann in einer Anwendung nützlich sein, die die Fill -Methode für zwei oder mehr SqlDataAdapter Objekte aufrufen muss. Wenn bereits SqlConnection geöffnet ist, müssen Sie explizit Schließen oder Dispose aufrufen, um es zu schließen.

Wenn eine Instanz von SqlDataAdapter erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt.

Eigenschaften	Anfangswert
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Sie können den Wert einer dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Gilt für:

SqlDataAdapter(String, String)

Initialisiert eine neue Instanz der SqlDataAdapter-Klasse mit einem SelectCommand und einer Verbindungszeichenfolge.

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)

Parameter

selectCommandText: String

Ein String, der eine Transact-SQL-SELECT-Anweisung oder eine gespeicherte Prozedur darstellt, die von der SelectCommand-Eigenschaft des SqlDataAdapter verwendet werden soll.

selectConnectionString: String

Verbindungszeichenfolge. Wenn die Verbindungszeichenfolge nicht Integrated Security = true verwendet, können Sie SqlDataAdapter(String, SqlConnection) und SqlCredential verwenden, um die Benutzer-ID und das Kennwort sicherer zu übergeben, als wenn Sie die Benutzer-ID und das Kennwort als Text in der Verbindungszeichenfolge angeben.

Beispiele

Im folgenden Beispiel wird ein SqlDataAdapter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Diese Überladung des SqlDataAdapter Konstruktors verwendet den selectCommandText -Parameter, um die SelectCommand -Eigenschaft festzulegen. Erstellt SqlDataAdapter und verwaltet die verbindung, die mit dem selectConnectionString -Parameter erstellt wurde.

Wenn eine Instanz von SqlDataAdapter erstellt wird, werden die folgenden Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt.

Eigenschaften	Anfangswert
MissingMappingAction	`MissingMappingAction.Passthrough`
MissingSchemaAction	`MissingSchemaAction.Add`

Sie können den Wert jeder dieser Eigenschaften durch einen separaten Aufruf der -Eigenschaft ändern.

Gilt für:

Freigeben über

SqlDataAdapter Konstruktoren

Definition

Überlädt

SqlDataAdapter()

Beispiele

Hinweise

Gilt für:

SqlDataAdapter(SqlCommand)

Parameter

Beispiele

Hinweise

Gilt für:

SqlDataAdapter(String, SqlConnection)

Parameter

Beispiele

Hinweise

Gilt für:

SqlDataAdapter(String, String)

Parameter

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen