SqlDataReader.GetStream(Int32) 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.8.6

擷取二進位、影像、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

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

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