Metodo Append (ADO)

Accoda un oggetto a un insieme. Se l'insieme è Fields, è possibile creare un nuovo oggetto Field prima che venga accodato all'insieme.

Sintassi

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

Parametri

raccolta
Oggetto raccolta.

Campi
Insieme Fields .

oggetto
Variabile oggetto che rappresenta l'oggetto da aggiungere.

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

Tipo
Valore 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
Opzionale. 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 valore DefinedSize maggiore di 255 byte vengono considerati come colonne a lunghezza variabile. Il valore predefinito per DefinedSize non è specificato.

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

FieldValue
Opzionale. Valore Variant che rappresenta il valore per il nuovo campo. Se non specificato, il campo viene aggiunto con un valore Null.

Osservazioni:

Insieme Parameters

È necessario impostare la proprietà Type di un oggetto Parameter prima di accodarla all'insieme 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 riduce al minimo le chiamate al provider e pertanto 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 desidera chiamare.

Utilizzare il metodo CreateParameter per creare oggetti Parameter con le impostazioni di proprietà appropriate e utilizzare il metodo Append per aggiungerli all'insieme 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 utilizzare questo metodo per popolare manualmente l'insieme Parameters per usare parametri.

Insieme 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 aggiungere 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.

Annotazioni

Per i nuovi oggetti Field aggiunti all'insieme Fields di di un oggetto Record , è necessario impostare la proprietà Value prima di specificare qualsiasi altra proprietà Field. Innanzitutto, è necessario assegnare un valore specifico per la proprietà Value e Update nell'insieme Fields chiamato. È quindi possibile accedere ad altre proprietà, ad esempio Type o attributi . Gli oggetti Field dei tipi di dati seguenti (DataTypeEnum) non possono essere aggiunti all'insieme Fields e genereranno 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 viene accodato, ma l'utilizzo può produrre risultati imprevedibili, incluse le perdite di memoria.

Recordset

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

Si verificherà un errore di run-time se il metodo Append viene chiamato nell'insieme Fields di un oggetto Recordset aperto o in un oggetto Recordset in cui è stata impostata la proprietà ActiveConnection . È possibile aggiungere solo campi a un oggetto Recordset non aperto e non ancora 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.

Registrazione

Un errore di run-time non si verificherà se il metodo Append viene chiamato nell'insieme Fields di un oggetto Record aperto. Il nuovo campo verrà aggiunto all'insieme Fields dell'oggetto Record . Se l'oggetto Record è derivato da un oggetto Recordset, il nuovo campo non verrà visualizzato nell'insieme Fields dell'oggetto Recordset.

Un campo inesistente può essere creato e accodato all'insieme Fields assegnando un valore all'oggetto field come se esistesse già nell'insieme. L'assegnazione attiverà la creazione automatica e l'aggiunta dell'oggetto Field e quindi l'assegnazione verrà completata.

Dopo aver accodato un oggetto Field all'insieme Fields di un oggetto Record , chiamare il metodo Update dell'insieme Fields per salvare la modifica.

Si applica a

• dell'insieme Fields (ADO)
• Parameters Collection (ADO)

Vedere anche

esempio di metodi Append e CreateParameter (VB)
esempio di metodi Append e CreateParameter (VC++)
metodo CreateParameter (ADO)
Metodo Delete (insieme ADO Fields)
metodo delete (insieme di parametri ADO)
metodo delete (RECORDSET ADO)
metodo Update