SqlDataReader.GetXmlReader(Int32) メソッド

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.dll

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に対する非同期操作が必要な場合は、サーバー上の NVARCHAR(MAX) に XML 列をキャストし、CreateでGetTextReaderを使用します。

SqlException XmlReaderから発生した例外は、XmlException例外としてスローされます。SqlExceptionの内部例外を確認してください。

GetCharsは、SequentialAccessが有効な場合にGetXmlReaderによって返されるオブジェクトで使用すると、InvalidOperationException例外を発生させます。

詳細については、「 SqlClient ストリーミング サポート」を参照してください。

適用対象