Metodo Update

Salva le modifiche apportate alla riga corrente di un oggetto Recordset o all'insieme Fields di un oggetto Record .

Sintassi

  
recordset.Update Fields, Values  
record.Fields.Update  

Parametri

Fields
facoltativo. Valore Variant che rappresenta un nome singolo o una 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 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 dal momento che chiama il metodo AddNew o dal momento che modifica i 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 Di aggiornamento .

  • Passare una matrice di nomi di campi e una matrice di valori con la chiamata Di aggiornamento .

Quando si usano matrici di campi e valori, è necessario che siano presenti un numero uguale di elementi in entrambe le matrici. Inoltre, l'ordine dei nomi dei campi deve corrispondere all'ordine dei valori del campo. Se il numero e l'ordine di campi e 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 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 eventuali modifiche apportate al record corrente o eliminare 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 nell'insieme 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

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