SqlDataReader.GetXmlReader(Int32) 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

형식 XML의 데이터를 XmlReader로 검색합니다.

public:
 virtual System::Xml::XmlReader ^ GetXmlReader(int i);

public virtual System.Xml.XmlReader GetXmlReader (int i);

abstract member GetXmlReader : int -> System.Xml.XmlReader
override this.GetXmlReader : int -> System.Xml.XmlReader

Public Overridable Function GetXmlReader (i As Integer) As XmlReader

매개 변수

i

Int32

지정된 열의 값입니다.

반환

XmlReader

반환된 개체입니다.

예외

InvalidOperationException

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

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

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

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

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

IndexOutOfRangeException

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

InvalidCastException

반환된 형식이 xml이 아닌 경우

설명

에서 반환된 GetXmlReader 개체는 XmlReader 비동기 작업을 지원하지 않습니다. 에 XmlReader대한 비동기 작업이 필요한 경우 XML 열을 서버의 NVARCHAR(MAX)로 캐스팅하고 와 함께 Create를 사용합니다GetTextReader.

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

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

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