Append 方法 (ADO)

發行項
05/04/2023

將物件附加至集合。如果集合是 Fields，您可以建立新的 Field 物件，然後再將其附加至集合。

語法

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

參數

collection
集合/物件。

欄位
Fields 集合。

object
物件變數，代表要附加的物件。

名稱
String 值，其中包含新 Field 物件的名稱，且不得與 fields 中的任何其他物件同名。

類型
DataTypeEnum值，其預設值為 adEmpty，指定新欄位的資料類型。 ADO 不支援下列資料類型，而且不應該在將新欄位附加至 Recordset 物件 (ADO) 時使用：adIDispatch、adIUnknown、adVariant。

DefinedSize
選擇性。 Long 值，代表新欄位的已定義大小，以字元或位元組為單位。此參數的預設值衍生自 Type。具有 DefinedSize 大於 255 個位元組的 Fields 會被視為可變長度資料行。未指定 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 並將值指派給欄位。

注意

新的 Field 物件若已附加至 Record 物件的 Fields 集合，您必須設定 Value 屬性，然後才能指定任何其他 Field 屬性。首先，必須已指派 Value 屬性的特定值，並呼叫 Fields 集合上的 Update。然後，可以存取 Type 或 Attributes 等其他屬性。下列資料類型 (DataTypeEnum) 的 Field 物件無法附加至 Fields 集合，而且會導致錯誤發生：adArray、adChapter、adEmpty、adPropVariant 和 adUserDefined。此外，ADO 不支援下列資料類型：adIDispatch、adIUnknown 和 adIVariant。針對這些類型，附加時不會發生任何錯誤，但使用方式可能會產生無法預期的結果，包括記憶體流失。

資料錄集

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

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

Record

如果在已開啟 Record 的 Fields 集合上呼叫 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 方法

共用方式為