共用方式為

Append 方法 （ADO）

  • 發行項

將物件附加至集合。 如果集合 Fields，則可以建立新的 Field 物件，再附加至集合。

語法

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

參數

集合
集合物件。

欄位
Fields 集合。

物件
物件變數，表示要附加的物件。

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

類型
DataTypeEnum 值，其預設值 為 adEmpty，指定新字段的數據類型。 ADO 不支援下列數據類型，而且不應該在將新字段附加至 Recordset 物件 （ADO）時使用：adIDispatch、adIUnknown、adVariant。

DefinedSize
自選。 Long 值，代表新欄位的已定義大小，以字元或位元組為單位。 此參數的預設值衍生自 Type。 DefinedSize 大於 255 個字節的欄位會被視為可變長度數據行。 未指定 DefinedSize 的預設值。

阿特裡布
自選。 FieldAttributeEnum 值，其預設值 adFldDefault，指定新字段的屬性。 如果未指定此值，欄位會包含衍生自 Type的屬性。

FieldValue
自選。 Variant，代表新欄位的值。 如果未指定，欄位會附加 Null 值。

言論

Parameters 集合

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

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

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

Fields 集合

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

注意

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

Recordset

如果您在呼叫 Append 方法之前未設定 CursorLocation 属性，CursorLocation 會在呼叫 Recordset 物件的 adUseClient （CursorLocationEnum 值） 自動設定。

如果在 已設定 ActiveConnection 屬性的 Fields 集合上呼叫 Append方法， 就會發生運行時錯誤。 您只能將欄位附加至尚未開啟且尚未連線至數據源的 Recordset。 這通常是當 Recordset 物件與 CreateRecordset 方法或指派給物件變數時， 這種情況。

記錄

如果在開啟 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 方法