OleDbDataAdapter.DeleteCommand Propriedade

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.2.24473.5

Origem:

OleDbDataAdapter.cs

Obtém ou define uma instrução SQL ou um procedimento armazenado para excluir registros do conjunto de dados.

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

public System.Data.OleDb.OleDbCommand? DeleteCommand { get; set; }

member this.DeleteCommand : System.Data.OleDb.OleDbCommand with get, set

Public Property DeleteCommand As OleDbCommand

Valor da propriedade

OleDbCommand

Um OleDbCommand usado durante o Update(DataSet) para excluir registros na fonte de dados que correspondem às linhas excluídas no DataSet.

Exemplos

O exemplo a seguir cria um OleDbDataAdapter e define as SelectCommand propriedades e DeleteCommand . Ele pressupõe que você já tenha criado um OleDbConnection objeto .

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

Comentários

Durante Update, se essa propriedade não estiver definida e as informações de chave primária estiverem presentes no DataSet, o DeleteCommand poderá ser gerado automaticamente se você definir a SelectCommand propriedade e usar o OleDbCommandBuilder. Em seguida, todos os comandos adicionais que você não definir são gerados pelo OleDbCommandBuilder. Esta lógica de geração requer que as informações da coluna principal estejam presente no DataSet. Para obter mais informações, confira Gerar comandos com CommandBuilders.

Quando DeleteCommand é atribuído a um criado OleDbCommandanteriormente, o OleDbCommand não é clonado. O DeleteCommand mantém uma referência ao objeto criado OleDbCommand anteriormente.

Confira também

• DataAdapters e DataReaders