SqlDataReader.GetStream(Int32) 메서드

정의

이진, 이미지, varbinary, UDT 및 variant 데이터 형식을 Stream으로 검색합니다.Retrieves binary, image, varbinary, UDT, and variant data types as a 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부터 시작)입니다.The zero-based column ordinal.

반환

스트림 개체입니다.A stream object.

예외

데이터 검색 중 연결이 끊기거나 닫힌 경우The connection drops or is closed during the data retrieval.

데이터 검색 중 SqlDataReader가 닫힌 경우The SqlDataReader is closed during the data retrieval.

읽을 준비가 된 데이터가 없는 경우(예를 들어, 첫 번째 Read()가 호출되지 않았거나 false를 반환한 경우)There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.Tried to read a previously-read column in sequential mode.

진행 중인 비동기 작업이 없습니다.There was an asynchronous operation in progress. 이는 스트림을 읽는 동안 호출할 수 있기 때문에 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

존재하지 않는 열을 읽으려고 시도합니다.Trying to read a column that does not exist.

반환된 형식이 다음 형식 중 하나가 아닙니다.The returned type was not one of the types below:

- binary- binary

- image- image

- VarBinary- varbinary

- UDT- udt

설명

기본값은 ReadTimeout CommandTimeout값입니다. 하지만 GetStream를 통해 ReadTimeout를 수정할 수 있습니다.ReadTimeout defaults to the value of CommandTimeout; but you can modify ReadTimeout via GetStream.

Null 값은 Stream빈 값 (0 바이트)으로 반환 됩니다.Null values will be returned as an empty (zero bytes) Stream.

SequentialAccess가 적용 될 때 GetStream에서 반환 하는 개체에 사용 되는 경우 InvalidOperationException 예외가 발생 GetBytes.GetBytes will raise an InvalidOperationException exception when used on an object returned by GetStream when SequentialAccess is in effect.

Stream에서 발생 하는 예외 SqlException IOException 예외로 throw 됩니다. SqlException에 대 한 내부 예외를 확인 합니다.SqlException exceptions raised from Stream are thrown as IOException exceptions; check the inner exception for the SqlException.

GetStream에서 반환 되는 개체에는 다음 Stream 멤버를 사용할 수 없습니다.The following Stream members are not available for objects returned by GetStream:

  • System.io.stream.beginwriteBeginWrite

  • EndWriteEndWrite

  • 길이Length

  • 위치Position

  • 찾지Seek

  • SetLengthSetLength

  • WriteWrite

  • WriteByteWriteByte

  • WriteTimeoutWriteTimeout

연결 속성이 ContextConnection=trueGetStream는 순차 (SequentialAccess) 및 비 순차 (Default) 액세스 모두에 대해 동기 데이터 검색만 지원 합니다.When the connection property ContextConnection=true, GetStream only supports synchronous data retrieval for both sequential (SequentialAccess) and non-sequential (Default) access.

자세한 내용은 SqlClient 스트리밍 지원을 참조 하세요.For more information, see SqlClient Streaming Support.

적용 대상