OleDbDataAdapter.UpdateCommand Proprietà

Definizione

Ottiene o imposta un'istruzione SQL o una stored procedure usata per aggiornare i record nell'origine dati.

public System.Data.OleDb.OleDbCommand? UpdateCommand { get; set; }
[System.Data.DataSysDescription("DbDataAdapter_UpdateCommand")]
public System.Data.OleDb.OleDbCommand UpdateCommand { get; set; }
public System.Data.OleDb.OleDbCommand UpdateCommand { get; set; }

Valore della proprietà

Oggetto OleDbCommand usato durante Update(DataSet) per aggiornare i record nell'origine dati che corrispondono alle righe modificate di DataSet.

Attributi

Esempio

Nell'esempio seguente viene creato un oggetto OleDbDataAdapter e vengono impostate le SelectCommand proprietà e UpdateCommand . Presuppone che sia già stato creato un OleDbConnection oggetto.

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

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM dbo.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 UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

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

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}

Commenti

Durante Update, se questa proprietà non è impostata e le informazioni sulla chiave primaria sono presenti in DataSet, è UpdateCommand possibile generare automaticamente se si imposta la SelectCommand proprietà e si usa .OleDbCommandBuilder Quindi, tutti i comandi aggiuntivi che non si impostano vengono generati dall'oggetto OleDbCommandBuilder. Questa logica di generazione richiede che le informazioni sulla colonna chiave siano presenti in DataSet. Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.

Quando UpdateCommand viene assegnato a un oggetto creato OleDbCommandin precedenza, l'oggetto OleDbCommand non viene clonato. Mantiene UpdateCommand un riferimento all'oggetto creato OleDbCommand in precedenza.

Nota

Se l'esecuzione di questo comando restituisce righe, queste righe possono essere unite a DataSet seconda della modalità di impostazione UpdatedRowSource della proprietà dell'oggetto OleDbCommand .

Si applica a

Prodotto Versioni
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)