Metodo Update

  • Articolo

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. Valore Variant che rappresenta un nome singolo o matrice Variant che rappresenta nomi o posizioni ordinali del campo o dei campi da modificare.

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

Osservazioni

recordset

Usare il metodo Update per salvare le modifiche apportate al record corrente di un oggetto Recordset dal momento della chiamata al metodo AddNew o dal momento della 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 campi e una matrice di valori con la chiamata Update.

Quando si usano matrici di campi e valori, è necessario che sia presente un numero uguale di elementi in entrambe le matrici. L'ordine dei nomi di campo deve inoltre 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 più modifiche in uno o più record in locale finché 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 al record corrente prima di trasmettere le modifiche in batch al provider.

Se ci si sposta 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 eventuali modifiche apportate al record corrente o ignorare un record appena aggiunto.

Il record corrente rimane corrente dopo aver chiamato il metodo Update.

Registra

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

Ad esempio, i campi eliminati con il metodo Delete sono contrassegnati immediatamente per l'eliminazione, ma rimangono nella raccolta. Il metodo Update deve essere chiamato per eliminare effettivamente questi campi dalla raccolta del provider.

Si applica a

Raccolta Fields (ADO)

Oggetto Recordset (ADO)

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