SqlDataReader.GetTextReader(Int32) 메서드

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.dll

Char, NChar, NText, NVarChar, text, varChar 및 Variant 데이터 형식을 .로 TextReader검색합니다.

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

매개 변수

i
Int32

검색할 열입니다.

반품

TextReader

반환된 개체입니다.

예외

InvalidOperationException

데이터 검색 중에 연결이 끊어지거나 닫힙니다.

SqlDataReader 데이터 검색 중에 닫힙니다.

읽을 준비가 된 데이터가 없습니다(예: 첫 번째 Read() 데이터가 호출되지 않았거나 false로 반환됨).

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

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

IndexOutOfRangeException

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

InvalidCastException

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

  • char

  • nchar (문자열 길이 함수)

  • ntext

  • nvarchar

  • 문자 메시지

  • varchar

설명

SqlException 예외에서 TextReader 발생한 예외는 예외로 IOException throw됩니다. 내부 예외 SqlException를 확인합니다.

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

GetChars는 적용되는 경우 반환 GetTextReader 된 개체에 사용할 때 SequentialAccess 예외를 발생 InvalidOperationException 합니다.

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

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

적용 대상