SqlDataReader.GetTextReader(Int32) 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.8.6

擷取 Char、NChar、 NText、 NVarChar、 文字、 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

傳回的型別不是下列型別：

• char

• NCHAR

• ntext

• NVARCHAR

• 文字

• varchar

備註

SqlException 從 TextReader 引發的例外狀況會擲回為 IOException 例外狀況;請檢查 的內部例外狀況 SqlException。

Null 值會以空的 (零個字節傳回，) TextReader。

GetChars會在作用中時傳回GetTextReader的物件上使用時SequentialAccess引發InvalidOperationException例外狀況。

當連接屬性 ContextConnection=true時， GetTextReader 只支援循序 (SequentialAccess) 和非循序 (Default) 存取同步數據擷取。

如需詳細資訊，請參閱 SqlClient 串流支援。