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

返された型は、次の型の 1 つではありません。

  • char

  • nchar

  • ntext

  • nvarchar(エヌヴァーチャー)

  • SMS 送信

  • varchar

注釈

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

null 値は、空の (0 バイト) TextReaderとして返されます。

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

接続プロパティが ContextConnection=true場合、 GetTextReader はシーケンシャル (SequentialAccess) アクセスと非シーケンシャル (Default) アクセスの両方に対してのみ同期データ取得をサポートします。

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

適用対象