Append 메서드(ADO)Append Method (ADO)

컬렉션에 개체를 추가 합니다.Appends an object to a collection. 컬렉션이 필드인경우 컬렉션에 추가 되기 전에 새 필드 개체를 만들 수 있습니다.If the collection is Fields, a new Field object can be created before it is appended to the collection.

구문Syntax

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

매개 변수Parameters

컬렉션collection
컬렉션 개체입니다.A collection object.

필드fields
Fields 컬렉션입니다.A Fields collection.

objectobject
추가할 개체를 나타내는 개체 변수입니다.An object variable that represents the object to be appended.

이름Name
Field 개체의 이름을 포함 하는 문자열 값으로, 필드 의 다른 개체와 이름이 달라 야 합니다.A String value that contains the name of the new Field object, and must not be the same name as any other object in fields.

유형Type
새 필드의 데이터 형식을 지정 하는 DataTypeEnum 값으로, 기본값은 adEmpty 입니다.A DataTypeEnum value, whose default value is adEmpty, that specifies the data type of the new field. 다음 데이터 형식은 ADO에서 지원 되지 않으므로 레코드 집합 개체 (ADO)에 새 필드를 추가할 때 사용 하면 안 됩니다. adIDispatch, adIUnknown, advariant.The following data types are not supported by ADO, and should not be used when appending new fields to a Recordset Object (ADO): adIDispatch, adIUnknown, adVariant.

DefinedSizeDefinedSize
선택 사항입니다.Optional. 새 필드의 정의 된 크기 (문자 또는 바이트)를 나타내는 Long 값입니다.A Long value that represents the defined size, in characters or bytes, of the new field. 이 매개 변수의 기본값은 형식 에서 파생 됩니다.The default value for this parameter is derived from Type. DefinedSize 가 255 바이트 보다 큰 필드는 가변 길이 열로 처리 됩니다.Fields that have a DefinedSize greater than 255 bytes are treated as variable length columns. DefinedSize 의 기본값은 지정 되지 않습니다.The default for DefinedSize is unspecified.

특성과Attrib
선택 사항입니다.Optional. 새 필드의 특성을 지정 하는 FieldAttributeEnum 값으로, 기본값은 adflddefault 입니다.A FieldAttributeEnum value, whose default value is adFldDefault, that specifies attributes for the new field. 이 값을 지정 하지 않으면 필드는 형식 에서 파생 된 특성을 포함 합니다.If this value is not specified, the field will contain attributes derived from Type.

FieldValueFieldValue
선택 사항입니다.Optional. 새 필드의 값을 나타내는 변형 입니다.A Variant that represents the value for the new field. 지정 하지 않으면 필드에 null 값이 추가 됩니다.If not specified, the field is appended with a null value.

설명Remarks

Parameters 컬렉션Parameters Collection

매개 변수 컬렉션에 추가 하기 전에 매개 변수 개체의 Type 속성을 설정 해야 합니다.You must set the Type property of a Parameter object before appending it to the Parameters collection. 가변 길이 데이터 형식을 선택 하는 경우에도 Size 속성을 0 보다 큰 값으로 설정 해야 합니다.If you select a variable-length data type, you must also set the Size property to a value greater than zero.

매개 변수를 직접 설명 하면 공급자에 대 한 호출이 최소화 되므로 저장 프로시저나 매개 변수가 있는 쿼리를 사용 하는 경우 성능이 향상 됩니다.Describing parameters yourself minimizes calls to the provider and therefore improves performance when you use stored procedures or parameterized queries. 그러나 호출 하려는 저장 프로시저 또는 매개 변수가 있는 쿼리와 연결 된 매개 변수의 속성을 알아야 합니다.However, you must know the properties of the parameters associated with the stored procedure or parameterized query that you want to call.

Createparameter 메서드를 사용 하 여 적절 한 속성 설정이 포함 된 매개 변수 개체를 만들고 Append 메서드를 사용 하 여 Parameters 컬렉션에 추가 합니다.Use the CreateParameter method to create Parameter objects with the appropriate property settings and use the Append method to add them to the Parameters collection. 이렇게 하면 매개 변수 정보에 대 한 공급자를 호출 하지 않고도 매개 변수 값을 설정 하 고 반환할 수 있습니다.This lets you set and return parameter values without having to call the provider for the parameter information. 매개 변수 정보를 제공 하지 않는 공급자에 작성 하는 경우 매개 변수를 사용 하기 위해이 메서드를 사용 하 여 매개 변수 컬렉션을 수동으로 채워야 합니다.If you are writing to a provider that does not supply parameter information, you must use this method to manually populate the Parameters collection in order to use parameters at all.

Fields 컬렉션Fields Collection

FieldValue 매개 변수는 Recordset 개체가 아닌 Record 개체에 Field 개체를 추가 하는 경우에만 유효 합니다.The FieldValue parameter is only valid when adding a Field object to a Record object, not to a Recordset object. Record 개체를 사용 하 여 필드를 추가 하 고 동시에 값을 제공할 수 있습니다.With a Record object, you can append fields and provide values at the same time. 레코드 집합 개체를 사용 하 여 레코드 집합 을 닫는 동안 필드를 만든 다음 레코드 집합 을 열고 필드에 값을 할당 합니다.With a Recordset object, you must create fields while the Recordset is closed, and then open the Recordset and assign values to the fields.

注意

Record 개체의 Fields 컬렉션에 추가 된 새 Field 개체의 경우 다른 필드 속성을 지정 하려면 먼저 Value 속성을 설정 해야 합니다.For new Field objects that have been appended to the Fields collection of a Record object, the Value property must be set before any other Field properties can be specified. 먼저 value 속성의 특정 값이 할당 되 고 라는 필드 컬렉션에 대해 업데이트 되어야 합니다.First, a specific value for the Value property must have been assigned and Update on the Fields collection called. 그런 다음 형식 또는 특성과 같은 다른 속성에 액세스할 수 있습니다.Then, other properties such as Type or Attributes can be accessed. 다음 데이터 형식 (DataTypeEnum)의 필드 개체를 Fields 컬렉션에 추가할 수 없으며 adarray, Adarray, adEmpty, adpropvariantadarray 와 같은 오류가 발생 합니다.Field objects of the following data types (DataTypeEnum) cannot be appended to the Fields collection and will cause an error to occur: adArray, adChapter, adEmpty, adPropVariant, and adUserDefined. 또한 ADO에서 adIDispatch, adIUnknownadIVariant 데이터 형식을 지원 하지 않습니다.Also, the following data types are not supported by ADO: adIDispatch, adIUnknown, and adIVariant. 이러한 형식에 대해 추가 된 경우 오류가 발생 하지는 않지만 사용 하면 메모리 누수를 포함 하 여 예기치 않은 결과가 발생할 수 있습니다.For these types, no error will occur when appended, but usage can produce unpredictable results including memory leaks.

레코드 집합Recordset

Append 메서드를 호출 하기 전에 CursorLocation 속성을 설정 하지 않으면 레코드 집합 개체의 Open 메서드가 호출 될 때 CursorLocation 가 자동으로 adUseClient ( CursorLocationEnum value)로 설정 됩니다.If you do not set the CursorLocation property before calling the Append method, CursorLocation will be set to adUseClient (a CursorLocationEnum value) automatically when the Open method of the Recordset object is called.

열린 레코드 집합Fields 컬렉션이 나 ActiveConnection 속성이 설정 된 레코드 집합 에서 Append 메서드를 호출 하면 런타임 오류가 발생 합니다.A run-time error will occur if the Append method is called on the Fields collection of an open Recordset, or on a Recordset where the ActiveConnection property has been set. 열려 있지 않고 데이터 원본에 아직 연결 되지 않은 레코드 집합 에만 필드를 추가할 수 있습니다.You can only append fields to a Recordset that is not open and has not yet been connected to a data source. 이는 일반적으로 CreateRecordset 메서드를 사용 하 여 레코드 집합 개체를 만들거나 개체 변수에 할당 하는 경우입니다.This is typically the case when a Recordset object is fabricated with the CreateRecordset method or assigned to an object variable.

레코드Record

열린 레코드Fields 컬렉션에 대해 Append 메서드를 호출 하는 경우에는 런타임 오류가 발생 하지 않습니다.A run-time error will not occur if the Append method is called on the Fields collection of an open Record. 새 필드가 Record 개체의 Fields 컬렉션에 추가 됩니다.The new field will be added to the Fields collection of the Record object. 레코드 를 레코드 집합 에서 파생 한 경우 새 필드는 레코드 집합 개체의 Fields 컬렉션에 표시 되지 않습니다.If the Record was derived from a Recordset, the new field will not appear in the Fields collection of the Recordset object.

필드가 이미 컬렉션에 있는 것 처럼 필드 개체에 값을 할당 하 여 존재 하지 않는 필드를 만든 다음 필드 컬렉션에 추가할 수 있습니다.A non-existent field can be created and appended to the Fields collection by assigning a value to the field object as if it already existed in the collection. 이 할당은 필드 개체의 자동 생성 및 추가를 트리거한 다음 할당을 완료 합니다.The assignment will trigger the automatic creation and appending of the Field object, and then the assignment will be completed.

Record 개체의 Fields 컬렉션에 필드 를 추가한 후에는 fields 컬렉션의 Update 메서드를 호출 하 여 변경 내용을 저장 합니다.After appending a Field to the Fields collection of a Record object, call the Update method of the Fields collection to save the change.

적용 대상Applies To

참고 항목See Also

Append 및 CreateParameter 메서드 예제 (VB) Append and CreateParameter Methods Example (VB)
Append 및 CreateParameter 메서드 예제 (VC + +) Append and CreateParameter Methods Example (VC++)
CreateParameter 메서드 (ADO) CreateParameter Method (ADO)
Delete 메서드 (ADO Fields Collection) Delete Method (ADO Fields Collection)
Delete 메서드 (ADO Parameters Collection) Delete Method (ADO Parameters Collection)
Delete 메서드 (ADO 레코드 집합) Delete Method (ADO Recordset)
Update 메서드Update Method