IDbDataAdapter.DeleteCommand Proprietà

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.

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

public System.Data.IDbCommand? DeleteCommand { get; set; }

member this.DeleteCommand : System.Data.IDbCommand with get, set

Public Property DeleteCommand As IDbCommand

Valore della proprietà

IDbCommand

Interfaccia IDbCommand utilizzata durante l'utilizzo del metodo Update(DataSet) per eliminare i record nell'origine dati relativi alle righe eliminate dal set di dati.

Esempio

Nell'esempio seguente viene creata un'istanza della classe ereditata OleDbDataAdapter e vengono impostate le SelectCommand proprietà e DeleteCommand . Presuppone che sia già stato creato un OleDbConnection oggetto .

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT CustomerID FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    dataAdapter.SelectCommand = command;

    // Create the DeleteCommand.
    command = new OleDbCommand(
        "DELETE * FROM Customers WHERE CustomerID = ?",
        connection);

    parameter = command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.DeleteCommand = command;

    return dataAdapter;
}

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 

    Dim dataAdapter As New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT CustomerID FROM Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    dataAdapter.SelectCommand = command

    ' Create the DeleteCommand.
    command = New OleDbCommand( _
        "DELETE * FROM Customers WHERE CustomerID = ?", _
        connection)

    parameter = command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.DeleteCommand = command

    Return dataAdapter
End Function

Commenti

Durante Update, se questa proprietà non è impostata e le informazioni sulla chiave primaria sono presenti in DataSet, è DeleteCommand possibile generare automaticamente se si imposta la SelectCommand proprietà di un provider di dati .NET Framework. Quindi, tutti i comandi aggiuntivi non impostati vengono generati da CommandBuilder. Questa logica di generazione richiede che le informazioni sulla colonna chiave siano presenti in DataSet. Per altre informazioni, vedere Generazione di comandi con CommandBuilders.

Quando DeleteCommand viene assegnato a un oggetto creato IDbCommandin precedenza, l'oggetto IDbCommand non viene clonato. Mantiene DeleteCommand un riferimento all'oggetto creato IDbCommand in precedenza.