다음을 통해 공유


GetChunk 메서드(ADO)

큰 텍스트 또는 이진 데이터 Field 개체의 전체 또는 일부 콘텐츠를 반환합니다.

구문

  
variable = field.GetChunk(Size)  

Return Value

Variant를 반환합니다.

매개 변수

크기
검색하려는 바이트 또는 문자 수와 같은 Long 식입니다.

설명

Field 개체에서 GetChunk 메서드를 사용하여 long 이진 또는 문자 데이터의 일부 또는 전체를 검색합니다. 시스템 메모리가 제한된 경우 GetChunk 메서드를 사용하여 전체 값이 아닌 일부의 long 값을 조작할 수 있습니다.

GetChunk 호출이 반환하는 데이터는 변수에 할당됩니다. Size가 나머지 데이터보다 크면 GetChunk 메서드는 빈 공백이 있는 패딩 변수 없이 나머지 데이터만 반환합니다. 필드가 비어 있으면 GetChunk 메서드는 null 값을 반환합니다.

각각의 이후 GetChunk 호출은 이전 GetChunk 호출이 중단된 위치에서 시작하는 데이터를 검색합니다. 그러나 한 필드에서 데이터를 검색한 다음, 현재 레코드에서 다른 필드의 값을 설정하거나 읽는 경우 ADO는 첫 번째 필드에서 데이터 검색을 완료한 것으로 가정합니다. 첫 번째 필드에서 GetChunk 메서드를 다시 호출하는 경우 ADO는 호출을 새 GetChunk 작업으로 해석하고 데이터의 시작 부분에서 읽기를 시작합니다. 첫 번째 Recordset 개체의 복제본이 아닌 다른 Recordset 개체의 필드에 액세스해도 GetChunk 작업이 중단되지 않습니다.

Field 개체의 Attributes 속성에 있는 adFldLong 비트가 True로 설정된 경우 해당 필드에 GetChunk 메서드를 사용할 수 있습니다.

Field 개체에서 GetChunk 메서드를 사용할 때 현재 레코드가 없으면 오류 3021(현재 레코드 없음)이 발생합니다.

참고

GetChunk 메서드는 Record 개체의 Field 개체에서 작동하지 않습니다. 이 메서드는 작업을 수행하지 않으며 런타임 오류를 생성합니다.

적용 대상

Field 개체

참고 항목

AppendChunk 및 GetChunk 메서드 예제(VB)
AppendChunk 및 GetChunk 메서드 예제(VC++)
AppendChunk 메서드(ADO)
Attributes 속성(ADO)