SqlDataAdapter.DeleteCommand Tulajdonság

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Lekéri vagy beállít egy Transact-SQL utasítást vagy tárolt eljárást a rekordok adatkészletből való törléséhez.

public:
 property System::Data::SqlClient::SqlCommand ^ DeleteCommand { System::Data::SqlClient::SqlCommand ^ get(); void set(System::Data::SqlClient::SqlCommand ^ value); };

public System.Data.SqlClient.SqlCommand DeleteCommand { get; set; }

member this.DeleteCommand : System.Data.SqlClient.SqlCommand with get, set

Public Property DeleteCommand As SqlCommand

Tulajdonság értéke

SqlCommand

Az SqlCommand adatbázis törölt sorainak Update(DataSet)megfelelő rekordok törlése során DataSet használt.

Példák

Az alábbi példa létrehozza SqlDataAdapter és beállítja a SelectCommand, InsertCommand, UpdateCommandés DeleteCommand tulajdonságokat. Feltételezi, hogy már létrehozott egy SqlConnection objektumot.

public static SqlDataAdapter CreateCustomerAdapter(
    SqlConnection connection)
{
    SqlDataAdapter adapter = new SqlDataAdapter();

    // Create the SelectCommand.
    SqlCommand command = new SqlCommand("SELECT * FROM Customers " +
        "WHERE Country = @Country AND City = @City", connection);

    // Add the parameters for the SelectCommand.
    command.Parameters.Add("@Country", SqlDbType.NVarChar, 15);
    command.Parameters.Add("@City", SqlDbType.NVarChar, 15);

    adapter.SelectCommand = command;

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

    // Add the parameters for the InsertCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");

    adapter.InsertCommand = command;

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

    // Add the parameters for the UpdateCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");
    SqlParameter parameter = command.Parameters.Add(
        "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    adapter.UpdateCommand = command;

    // Create the DeleteCommand.
    command = new SqlCommand(
        "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

    // Add the parameters for the DeleteCommand.
    parameter = command.Parameters.Add(
        "@CustomerID", SqlDbType.NChar, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    adapter.DeleteCommand = command;

    return adapter;
}

Public Function CreateCustomerAdapter( _
  ByVal connection As SqlConnection) As SqlDataAdapter

    Dim adapter As SqlDataAdapter = New SqlDataAdapter()

    ' Create the SelectCommand.
    Dim command As SqlCommand = New SqlCommand( _
        "SELECT * FROM Customers " & _
        "WHERE Country = @Country AND City = @City", connection)

    ' Add the parameters for the SelectCommand.
    command.Parameters.Add("@Country", SqlDbType.NVarChar, 15)
    command.Parameters.Add("@City", SqlDbType.NVarChar, 15)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New SqlCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
        "VALUES (@CustomerID, @CompanyName)", connection)

    ' Add the parameters for the InsertCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID")
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName")

    adapter.InsertCommand = command

    ' Create the UpdateCommand.
    command = New SqlCommand( _
        "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " & _
        "WHERE CustomerID = @oldCustomerID", connection)

    ' Add the parameters for the UpdateCommand.
    command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID")
    command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName")
    Dim parameter As SqlParameter = command.Parameters.Add( _
        "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    adapter.UpdateCommand = command

    ' Create the DeleteCommand.
    command = New SqlCommand( _
        "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection)

    ' Add the parameters for the DeleteCommand.
    command.Parameters.Add( _
        "@CustomerID", SqlDbType.NChar, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    adapter.DeleteCommand = command

    Return adapter
End Function

Megjegyzések

Ha Updateez a tulajdonság nincs beállítva, és az elsődleges kulcs információi szerepelnek a DataSettulajdonságban, a DeleteCommand rendszer automatikusan létrehozható, ha beállítja a SelectCommand tulajdonságot, és használja a SqlCommandBuilder. Ezután a nem beállított további parancsokat a SqlCommandBuilderrendszer a . Ez a generációs logika megköveteli, hogy a kulcsoszlopok adatai szerepeljenek a DataSet. További információ: Parancsok generálása commandbuilderekkel.

Ha DeleteCommand egy korábban létrehozotthoz SqlCommandvan rendelve, a SqlCommand rendszer nem klónozza. A DeleteCommand korábban létrehozott SqlCommand objektumra mutató hivatkozást tart fenn.

Minden olyan oszlophoz, amelyen az adatforrásba Updatepropagálja az adatokat, hozzá kell adni egy paramétert az InsertCommand, UpdateCommandvagy DeleteCommand. A SourceColumn paraméter tulajdonságát az oszlop nevére kell állítani. Ez azt jelzi, hogy a paraméter értéke nincs manuálisan beállítva, hanem az aktuálisan feldolgozott sor adott oszlopából származik.

Lásd még

• Adatok (ADO.NET)
• A .NET-keretrendszer Data Provider használata SQL Server
• ADO.NET áttekintése