Append 方法 (ADO)

將 物件附加至集合。 如果集合是 Fields,可以在將新的 Field 物件附加至集合之前建立。

語法

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

參數

收集
集合物件。

欄位
Fields集合。

object
物件變數,表示要附加的物件。

名稱
String值,其中包含新Field物件的名稱,且不得與欄位中的任何其他物件相同。

型別
DataTypeEnum值,其預設值為adEmpty,指定新欄位的資料類型。 ADO 不支援下列資料類型,不應在將新欄位附加至 Recordset 物件 (ADO) 時使用: adIDispatchadIUnknownadVariant

DefinedSize
選擇性。 Long值,表示新欄位的已定義大小,以字元或位元組為單位。 此參數的預設值衍生自 TypeDefinedSize大於 255 個位元組的欄位會被視為可變長度資料行。 未指定 DefinedSize的預設值。

Attrib
選擇性。 FieldAttributeEnum值,其預設值為adFldDefault,指定新欄位的屬性。 如果未指定此值,欄位將包含衍生自 Type的屬性。

FieldValue
選擇性。 Variant,表示新欄位的值。 如果未指定,欄位會附加 Null 值。

備註

Parameters 集合

您必須先設定Parameter物件的Type屬性,再將它附加至Parameters集合。 如果您選取可變長度資料類型,您也必須將 Size 屬性設定為大於零的值。

自行描述參數會將提供者的呼叫降至最低,因此當您使用預存程式或參數化查詢時,可改善效能。 不過,您必須知道與要呼叫之預存程式或參數化查詢相關聯的參數屬性。

使用 CreateParameter 方法來建立具有適當屬性設定的 Parameter 物件,並使用 Append 方法將它們新增至 Parameters 集合。 這可讓您設定和傳回參數值,而不需要呼叫參數資訊的提供者。 如果您要寫入未提供參數資訊的提供者,您必須使用這個方法來手動填入 Parameters 集合,才能完全使用參數。

Fields 集合

只有在將 Field 物件加入至 Record物件,而非Recordset物件時,FieldValue參數才有效。 使用 Record 物件時,您可以附加欄位並提供值。 使用 Recordset 物件時,您必須在 Recordset 關閉時建立欄位,然後開啟 Recordset 並將值指派給欄位。

注意

對於已附加至Record物件的Fields集合的新Field物件,必須先設定Value屬性,才能指定任何其他Field屬性。 首先,必須在名為 的Fields集合上指派Value屬性的特定值和更新。 然後,可以存取其他屬性,例如 TypeAttributes 。 下列資料類型的欄位物件 (DataTypeEnum) 無法附加至Fields集合,而且會導致錯誤發生:adArrayadChapteradEmptyadPropVariantadUserDefined。 此外,ADO 不支援下列資料類型: adIDispatchadIUnknownadIVariant。 針對這些類型,附加時不會發生任何錯誤,但使用量可能會產生無法預期的結果,包括記憶體流失。

資料錄集

如果您在呼叫Append方法之前未設定CursorLocation屬性,當呼叫Recordset物件的Open方法時,CursorLocation會設定為adUseClient (CursorLocationEnum值) 自動。

如果在開啟RecordsetFields集合上呼叫Append方法,或在已設定ActiveConnection屬性的Recordset上呼叫 Append 方法,就會發生執行階段錯誤。 您只能將欄位附加至尚未開啟且尚未連線至資料來源的 Recordset 。 這通常是使用CreateRecordset方法產生Recordset物件,或指派給物件變數的情況。

Record

如果在開啟 RecordFields集合上呼叫Append方法,則不會發生執行階段錯誤。 新欄位將會新增至Record物件的Fields集合。 如果 Record 衍生自Recordset,新欄位就不會出現在Recordset物件的Fields集合中。

您可以藉由將值指派給欄位物件,就像它已存在於集合中一樣,建立並附加至 Fields 集合中不存在的欄位。 指派將會觸發 Field 物件的自動建立和附加,然後完成指派。

Field附加至Record物件的Fields集合之後,請呼叫Fields集合的Update方法以儲存變更。

套用至

另請參閱

Append 和 CreateParameter 方法範例 (VB)
Append 和 CreateParameter 方法範例 (VC++)
CreateParameter 方法 (ADO)
Delete 方法 (ADO Fields 集合)
Delete 方法 (ADO Parameters 集合)
Delete 方法 (ADO Recordset)
Update 方法