SqlDataReader.GetXmlReader(Int32) 메서드

정의

형식 XML의 데이터를 XmlReader로 검색합니다.Retrieves data of type XML as an 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

지정된 열의 값입니다.The value of the specified column.

반환

반환된 개체입니다.The returned 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).

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.Trying 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.

반환된 형식이 xml이 아닌 경우The returned type was not xml.

설명

GetXmlReader에서 반환 된 XmlReader 개체가 비동기 작업을 지원 하지 않습니다.The XmlReader object returned by GetXmlReader does not support asynchronous operations. XmlReader에 대 한 비동기 작업이 필요한 경우에는 서버의 XML 열을 NVARCHAR (MAX)로 캐스팅 하 고 CreateGetTextReader를 사용 합니다.If you require asynchronous operations on an XmlReader, cast the XML column to an NVARCHAR(MAX) on the server and use GetTextReader with Create.

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

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

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

적용 대상