SqlDataAdapter-Konstruktor (String, String)

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

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Sub New ( _
    selectCommandText As String, _
    selectConnectionString As String _
)
'Usage
Dim selectCommandText As String
Dim selectConnectionString As String

Dim instance As New SqlDataAdapter(selectCommandText, selectConnectionString)

public SqlDataAdapter (
    string selectCommandText,
    string selectConnectionString
)

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

public SqlDataAdapter (
    String selectCommandText, 
    String selectConnectionString
)

public function SqlDataAdapter (
    selectCommandText : String, 
    selectConnectionString : String
)

Parameter

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

• selectConnectionString
  Die Verbindungszeichenfolge.

Hinweise

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

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 gesonderten Aufruf der betreffenden Eigenschaft ändern.

Beispiel

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

Public Function CreateSqlDataAdapter(ByVal commandText As String, _
    ByVal connectionString As String) As SqlDataAdapter

    Dim adapter As SqlDataAdapter = New SqlDataAdapter(commandText, connectionString)
    Dim connection As SqlConnection = 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
End Function

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlDataAdapter-Klasse
SqlDataAdapter-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Ändern von Daten in ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server