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.

Комментарии

Объект XmlReader, возвращенный GetXmlReader, не поддерживает асинхронные операции.The XmlReader object returned by GetXmlReader does not support asynchronous operations. Если требуются асинхронные операции с XmlReader, приведите XML-столбец к типу NVARCHAR (MAX) на сервере и используйте GetTextReader с Create.If you require asynchronous operations on an XmlReader, cast the XML column to an NVARCHAR(MAX) on the server and use GetTextReader with Create.

SqlException исключения, вызванные из XmlReader, вызываются как исключения XmlException; Проверьте внутреннее исключение для SqlException.SqlException exceptions raised from XmlReader are thrown as XmlException exceptions; check the inner exception for the SqlException.

GetChars вызовет исключение InvalidOperationException при использовании объекта, возвращаемого GetXmlReader, когда действует SequentialAccess.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.

Применяется к