다음을 통해 공유


Position 속성(ADO)

Stream 개체 내의 현재 위치를 나타냅니다.

설정 및 반환 값

스트림의 시작 부분에서 현재 위치의 오프셋(바이트 수)을 지정하는 Long 값을 설정하거나 반환합니다. 기본값은 0이며, 이는 스트림의 첫 번째 바이트를 나타냅니다.

설명

현재 위치는 스트림이 끝난 후 지점으로 이동할 수 있습니다. 스트림의 끝부분에 현재 위치를 지정하면 Stream 개체의 Size가 그에 따라 증가합니다. 이러한 방식으로 추가된 모든 새 바이트는 null입니다.

참고

Position은 항상 바이트를 측정합니다. 멀티바이트 문자 집합을 사용하는 텍스트 스트림의 경우 위치를 문자 크기로 곱하여 문자 번호를 결정합니다. 예를 들어 2바이트 문자 집합의 경우 첫 번째 문자는 위치 0, 두 번째 문자는 위치 2, 세 번째 문자는 위치 4 등에 있습니다.

참고

음수 값은 Stream의 현재 위치를 변경하는 데 사용할 수 없습니다. Position에는 양수만 사용할 수 있습니다.

참고

읽기 전용 Stream 개체의 경우 PositionStreamSize보다 큰 값으로 설정된 경우 ADO에서 오류를 반환하지 않습니다. 이렇게 하면 Stream의 크기가 변경되지 않거나 어떤 방식으로든 Stream 콘텐츠가 변경되지 않습니다. 그러나 이렇게 하면 의미 없는 Position 값이 발생하므로 방지해야 합니다.

적용 대상

스트림 개체(ADO)

참고 항목

Charset 속성(ADO)