다음을 통해 공유


SqlDataReader.GetStream(Int32) 메서드

정의

이진, 이미지, varbinary, UDT 및 variant 데이터 형식을 Stream으로 검색합니다.

public:
 override System::IO::Stream ^ GetStream(int i);
public override System.IO.Stream GetStream (int i);
override this.GetStream : int -> System.IO.Stream
Public Overrides Function GetStream (i As Integer) As Stream

매개 변수

i
Int32

열 서수(0부터 시작)입니다.

반환

스트림 개체입니다.

예외

데이터 검색 중 연결이 끊기거나 닫힌 경우

데이터 검색 중 SqlDataReader가 닫힌 경우

읽을 준비가 된 데이터가 없는 경우(예를 들어, 첫 번째 Read()가 호출되지 않았거나 false를 반환한 경우)

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.

진행 중인 비동기 작업이 없습니다. 이는 스트림을 읽는 동안 호출할 수 있기 때문에 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.

존재하지 않는 열을 읽으려고 시도합니다.

반환된 형식이 다음 형식 중 하나가 아닙니다.

  • binary

  • 이미지

  • varbinary

  • udt

설명

ReadTimeout는 의 값CommandTimeout으로 기본 설정되지만 를 통해 GetStream수정 ReadTimeout 할 수 있습니다.

Null 값은 빈(0바이트) Stream로 반환됩니다.

GetBytes가 적용되는 경우 에서 반환 GetStream 된 개체에 사용할 때 SequentialAccess 예외가 발생 InvalidOperationException 합니다.

SqlException에서 Stream 발생한 예외는 예외로 IOException throw됩니다. 에 대한 내부 예외를 SqlException검사.

에서 반환GetStream된 개체에는 다음 Stream 멤버를 사용할 수 없습니다.

  • BeginWrite

  • EndWrite

  • 길이

  • 위치

  • Seek

  • SetLength

  • 쓰기

  • WriteByte

  • WriteTimeout

연결 속성 ContextConnection=trueGetStream 인 경우 는 순차적() 및 비Default순차적(SequentialAccess) 액세스 모두에 대해 동기 데이터 검색만 지원합니다.

자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

적용 대상