Metodo Append (ADO)

  • Articolo

Accoda un oggetto a una raccolta. Se la raccolta è Fields, è possibile creare un nuovo oggetto Field prima di aggiungerlo alla raccolta.

Sintassi

  
collection.Append object  
fields.Append Name, Type, DefinedSize, Attrib, FieldValue

Parametri

collection
Oggetto della raccolta.

campi
Raccolta Fields.

object
Variabile oggetto che rappresenta l'oggetto da accodare.

Nome
Valore String che contiene il nome del nuovo oggetto Field e non deve essere lo stesso nome di qualsiasi altro oggetto in Fields.

Tipo
Oggetto DataTypeEnum, il cui valore predefinito è adEmpty, che specifica il tipo di dati del nuovo campo. I tipi di dati seguenti non sono supportati da ADO e non devono essere usati durante l'aggiunta di nuovi campi a un oggetto Recordset (ADO): adIDispatch, adIUnknown, adVariant.

DefinedSize
facoltativo. Valore Long che rappresenta le dimensioni definite, in caratteri o byte, del nuovo campo. Il valore predefinito per questo parametro è derivato da Type. I campi con un valore DefinedSize maggiore di 255 byte vengono considerati come colonne di lunghezza variabile. L'impostazione predefinita per DefinedSize non è specificata.

Attrib
facoltativo. Valore FieldAttributeEnum, il cui valore predefinito è adFldDefault, che specifica gli attributi per il nuovo campo. Se questo valore non è specificato, il campo conterrà attributi derivati da Type.

FieldValue
facoltativo. Oggetto Variant che rappresenta il valore per il nuovo campo. Se non specificato, al campo viene accodato un valore Null.

Osservazioni

Raccolta Parameters

È necessario impostare la proprietà Type di un oggetto Parameter prima di aggiungerlo alla raccolta Parameters. Se si seleziona un tipo di dati a lunghezza variabile, è necessario impostare anche la proprietà Size su un valore maggiore di zero.

La descrizione dei parametri consente di ridurre al minimo le chiamate al provider e quindi migliora le prestazioni quando si usano stored procedure o query con parametri. È tuttavia necessario conoscere le proprietà dei parametri associati alla stored procedure o alla query con parametri che si vuole chiamare.

Usare il metodo CreateParameter per creare oggetti Parameter con le impostazioni di proprietà appropriate e usare il metodo Append per aggiungerli alla raccolta Parameters. In questo modo è possibile impostare e restituire i valori dei parametri senza dover chiamare il provider per le informazioni sui parametri. Se si scrive in un provider che non fornisce informazioni sui parametri, è necessario usare questo metodo per popolare manualmente la raccolta Parameters e poter usare i parametri.

Raccolta Fields

Il parametro FieldValue è valido solo quando si aggiunge un oggetto Field a un oggetto Record, non a un oggetto Recordset. Con un oggetto Record è possibile accodare campi e specificare i valori contemporaneamente. Con un oggetto Recordset è necessario creare campi mentre l'oggetto Recordset è chiuso e quindi aprire l'oggetto Recordset e assegnare valori ai campi.

Nota

Per i nuovi oggetti Field accodati alla raccolta Fields di un oggetto Record, la proprietà Value deve essere impostata prima di specificare qualsiasi altra proprietà di Field. Prima di tutto, è necessario assegnare un valore specifico per la proprietà Value e chiamare il metodo Update sulla raccolta Fields. È quindi possibile accedere ad altre proprietà, ad esempio Type o Attributes. Gli oggetti Field dei tipi di dati seguenti (DataTypeEnum) non possono essere accodati alla raccolta Fields e causeranno un errore: adArray, adChapter, adEmpty, adPropVariant e adUserDefined. Inoltre, i tipi di dati seguenti non sono supportati da ADO: adIDispatch, adIUnknown e adIVariant. Per questi tipi, non si verificherà alcun errore quando vengono accodati, ma il loro utilizzo può generare risultati imprevedibili, tra cui perdite di memoria.

recordset

Se non si imposta la proprietà CursorLocation prima di chiamare il metodo Append, CursorLocation verrà impostato automaticamente su adUseClient (valore di CursorLocationEnum) quando viene chiamato il metodo Open dell'oggetto Recordset.

Si verificherà un errore di runtime se il metodo Append viene chiamato sulla raccolta Fields di un oggetto Recordset aperto o su un oggetto Recordset in cui è stata impostata la proprietà ActiveConnection. È possibile accodare i campi solo a un oggetto Recordset non aperto e che non è ancora stato connesso a un'origine dati. Questo è in genere il caso in cui un oggetto Recordset viene creato con il metodo CreateRecordset o assegnato a una variabile oggetto.

Registra

Non si verificano errori di runtime se il metodo Append viene chiamato sulla raccolta Fields di un oggetto Record aperto. Il nuovo campo verrà aggiunto alla raccolta Fields dell'oggetto Record. Se l'oggetto Record è stato derivato da un oggetto Recordset, il nuovo campo non verrà visualizzato nella raccolta Fields dell'oggetto Recordset.

Un campo non esistente può essere creato e accodato alla raccolta Fields assegnando un valore all'oggetto Field come se esistesse già nella raccolta. L'assegnazione attiverà la creazione automatica e l'accodamento dell'oggetto Field per consentire il completamento dell'assegnazione.

Dopo aver accodato un oggetto Field alla raccolta Fields di un oggetto Record, chiamare il metodo Update della raccolta Fields per salvare la modifica.

Si applica a

Vedere anche

Esempio dei metodi Append e CreateParameter (VB)
Esempio dei metodi Append e CreateParameter (VC++)
Metodo CreateParameter (ADO)
Metodo Delete (raccolta Fields ADO)
Metodo Delete (raccolta Parameters ADO)
Metodo Delete (Recordset - ADO)
Metodo Update