Metodo Update

Salva le modifiche apportate alla riga corrente di un oggetto Recordset o alla raccolta Fields di un oggetto Record.

Sintassi

  
recordset.Update Fields, Values  
record.Fields.Update  

Parametri

Fields
facoltativo. Variant che rappresenta un singolo nome o una matrice Variant che rappresenta i nomi o le posizioni ordinali del campo o dei campi da modificare.

Valori
facoltativo. Variant che rappresenta un singolo valore o una matrice Variant che rappresenta i valori per il campo o i campi nel nuovo record.

Commenti

recordset

Usare il metodo Update per salvare le modifiche apportate al record corrente di un oggetto Recordset dopo la chiamata al metodo AddNew o dopo la modifica dei valori dei campi in un record esistente. L'oggetto Recordset deve supportare gli aggiornamenti.

Per impostare i valori dei campi, eseguire una delle operazioni seguenti:

  • Assegnare valori alla proprietà Value di un oggetto Field e chiamare il metodo Update.

  • Passare un nome di campo e un valore come argomenti con la chiamata Update.

  • Passare una matrice di nomi di campo e una matrice di valori con la chiamata Update.

Quando si usano matrici di campi e valori, deve essere presente un numero uguale di elementi in entrambe le matrici. Inoltre, l'ordine dei nomi dei campi deve corrispondere all'ordine dei valori dei campi. Se il numero e l'ordine dei campi e dei valori non corrispondono, si verifica un errore.

Se l'oggetto Recordset supporta l'aggiornamento batch, è possibile memorizzare nella cache più modifiche a uno o più record in locale fino a quando non si chiama il metodo UpdateBatch. Se si modifica il record corrente o si aggiunge un nuovo record quando si chiama il metodo UpdateBatch, ADO chiamerà automaticamente il metodo Update per salvare eventuali modifiche in sospeso nel record corrente prima di trasmettere le modifiche in batch al provider.

Se si passa dal record che si sta aggiungendo o modificando prima di chiamare il metodo Update, ADO chiamerà automaticamente Update per salvare le modifiche. È necessario chiamare il metodo CancelUpdate se si desidera annullare le modifiche apportate al record corrente o rimuovere un record appena aggiunto.

Il record corrente rimane corrente dopo la chiamata al metodo Update.

Registra

Il metodo Update consente di finalizzare aggiunte, eliminazioni e aggiornamenti ai campi nella raccolta Fields di un oggetto Record.

Ad esempio, i campi eliminati con il metodo Delete vengono contrassegnati per l'eliminazione immediata, ma rimangono nella raccolta. È necessario chiamare il metodo Update per eliminare effettivamente questi campi dalla raccolta del provider.

Si applica a

Vedere anche

Esempio dei metodi Update e CancelUpdate (VB)
Esempio dei metodi Update e CancelUpdate (VC++)
Metodo AddNew (ADO)
Metodo CancelUpdate (ADO)
Proprietà EditMode
Metodo UpdateBatch