SqlDataReader.GetStream(Int32) 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

擷取二進位、影像、varbinary、UDT 和 variant 資料型別做為Stream。

public:
 override System::IO::Stream ^ GetStream(int i);

public override System.IO.Stream GetStream (int i);

override this.GetStream : int -> System.IO.Stream

Public Overrides Function GetStream (i As Integer) As Stream

參數

i

Int32

以零為基底的資料行序數。

傳回

Stream

資料流物件。

例外狀況

InvalidOperationException

在資料擷取期間，連線中斷或關閉。

SqlDataReader在資料擷取期間已關閉。

沒有可供讀取的資料 (例如，第一個 Read() 沒有被呼叫，或傳回 false)。

嘗試在循序模式下讀取先前讀取的資料行。

有進行中的非同步作業。 當在循序模式中執行時，此適用於所有 Get* 方法，因為在讀取資料流時可能會呼叫它們。

IndexOutOfRangeException

嘗試讀取不存在的資料行。

InvalidCastException

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

• BINARY

• image

• varbinary

• udt

備註

ReadTimeout預設為 的值 CommandTimeout ，但您可以透過 GetStream 修改 ReadTimeout 。

Null 值會以空的 (零個位元組傳回，) Stream 。

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

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

下列 Stream 成員不適用於 所 GetStream 傳回的物件：

• BeginWrite

• EndWrite

• 長度

• 位置

• Seek

• SetLength

• 寫入

• WriteByte

• WriteTimeout

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