將對象追加到集合中。如果集合是 Fields,可以先創(chuàng)建新的 Field 對象然后再將其追加到集合中。
語法
collection.Append object
fields.Append Name, Type, DefinedSize, Attrib
參數(shù)
collection 集合對象。
fields Fields 集合。
object 對象變量,代表所要追加對象。
Name 字符串,新 Field 對象的名稱,不得與 fields 中的任何其他對象同名。
Type DataTypeEnum 類型,其默認值為 adEmpty。新字段的數(shù)據(jù)類型。
DefinedSize 可選,長整型,指示新字段的定義大?。ㄒ宰址蜃止?jié)為單位)。該參數(shù)的默認值源于 Type (默認的 Type 為 adEmpty,默認的 DefinedSize 未指定)。
Attrib 可選,FieldAttributeEnum,其默認值是 adFldDefault。指定新字段的屬性。如果該值未指定,字段將包含源于 Type 的屬性。
參數(shù)
在集合上使用 Append 方法可將對象添加到該集合,此方法僅在 Command 對象的 Parameters 集合上有效。在將 Parameter 對象追加到 Parameters 集合中之前必須設置其 Type 屬性。如果選定了變長數(shù)據(jù)類型,則必須將 Size 屬性設置為大于零的值。
通過對參數(shù)作出說明,可以最大程度地減少對提供者的調(diào)用,進而在使用存儲過程或參數(shù)化查詢時提高性能,但必須了解與所要調(diào)用的存儲過程或參數(shù)化查詢相關聯(lián)的參數(shù)屬性。使用 CreateParameter 方法可創(chuàng)建具有適當屬性設置的 Parameter 對象,而使用 Append 方法則可將它們添加到 Parameters 集合。這樣可以不必調(diào)用參數(shù)信息的提供者而設置和返回參數(shù)值。如果寫到不提供參數(shù)信息的提供者,則必須使用該方法手工填寫 Parameters 集合以便能夠完全使用參數(shù)。
字段
如果在調(diào)用 fields.Append 方法前您沒有設置 CursorLocation 屬性,當使用 Open 方法打開 Recordset 時,CursorLocation 將被自動設置為 adUseClient。
對打開的 Recordset 或已設置 ActiveConnection 屬性的 Recordset,調(diào)用其 fields.Append 方法將引發(fā)運行時錯誤。只能將字段追加到?jīng)]有打開并且尚未連接到數(shù)據(jù)源的 Recordset。一般地,通過 CreateRecordset 方法或通過將新 Recordset 對象顯式賦給對象變量所創(chuàng)建的都是新 Recordset 對象。