SqlFileStream 類別

定義

命名空間:

System.Data.SqlTypes

組件:

System.Data.SqlClient.dll

組件:

System.Data.dll

公開使用 FILESTREAM 資料行屬性儲存為位元組序列的 SQL Server 資料。

public ref class SqlFileStream sealed : System::IO::Stream

public sealed class SqlFileStream : System.IO.Stream

type SqlFileStream = class
    inherit Stream

Public NotInheritable Class SqlFileStream
Inherits Stream

繼承

Object

Stream

SqlFileStream

繼承

Object

MarshalByRefObject

Stream

SqlFileStream

備註

類別 SqlFileStream 可用來處理 varbinary(max) 以 FILESTREAM 屬性儲存在 SQL Server 2008 資料庫中的資料。 您必須安裝 .NET Framework 3.5 SP1 (或更新版本) ，才能使用 SqlFileStream FILESTREAM 資料。

在資料行上 varbinary(max) 指定 FILESTREAM 屬性會導致SQL Server將資料儲存在本機 NTFS 檔案系統中，而不是儲存在資料庫檔案中。 Transact-SQL 語句可在伺服器內提供資料操作功能，而 Win32 檔案系統介面則提供資料的串流存取。

注意

儲存在 FILESTREAM 資料行中的個別檔案無法直接從 NTFS 檔案系統開啟。 串流 FILESTREAM 資料只適用于SQL Server交易的內容。

類別 SqlFileStream 衍生自 Stream 類別，代表來自某些任意資料來源位元組序列的抽象概念，例如檔案或記憶體區塊。 您可以從 FILESTREAM 讀取資料，方法是將資料從資料流程傳輸到資料結構，例如位元組陣列。 您可以將資料從資料結構傳輸到資料流程，以寫入 FILESTREAM。 您也可以在資料流程內搜尋，這可讓您查詢和修改資料流程中目前位置的資料。

如需概念檔和程式碼範例，請參閱 FILESTREAM 資料。

如需有關在 SQL Server 上設定 FILESTREAM 資料的檔，請參閱《線上叢書》中的SQL Server 設計及實作 FILESTREAM 儲存體。

建構函式

SqlFileStream(String, Byte[], FileAccess)	初始化 SqlFileStream 類別的新執行個體。
SqlFileStream(String, Byte[], FileAccess, FileOptions, Int64)	初始化 SqlFileStream 類別的新執行個體。

屬性

CanRead	取得表示目前資料流是否支援讀取的值。
CanSeek	取得表示目前資料流是否支援搜尋的值。
CanTimeout	取得指出目前資料流是否會逾時的值。
CanTimeout	取得值，該值判斷目前的資料流是否可以逾時。 (繼承來源 Stream)
CanWrite	取得表示目前資料流是否支援寫入的值。
Length	取得指出目前資料流長度的值 (位元組)。
Name	取得傳遞至建構函式的 SqlFileStream 邏輯路徑。
Position	取得或設定在目前資料流中的位置。
ReadTimeout	取得或設定值 (以毫秒為單位)，該值決定資料流在逾時前將嘗試讀取多長時間。
ReadTimeout	取得或設定值 (以毫秒為單位)，該值決定資料流在逾時前將嘗試讀取多長時間。 (繼承來源 Stream)
TransactionContext	取得或設定這個 SqlFileStream 物件的異動內容。
WriteTimeout	取得或設定毫秒值，該值決定在逾時前資料流將嘗試寫入多長時間。
WriteTimeout	取得或設定毫秒值，該值決定在逾時前資料流將嘗試寫入多長時間。 (繼承來源 Stream)

方法

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	開始非同步的讀取作業。
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	開始非同步的讀取作業。 (請考慮用 ReadAsync(Byte[], Int32, Int32) 替代。) (繼承來源 Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	開始非同步的寫入作業。
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	開始非同步的寫入作業。 (請考慮用 WriteAsync(Byte[], Int32, Int32) 替代。) (繼承來源 Stream)
Close()	關閉目前資料流和釋放與目前資料流相關聯的任何資源 (例如通訊端和檔案控制代碼)。 請確定正確地處置資料流，而非呼叫這個方法。 (繼承來源 Stream)
CopyTo(Stream)	從目前資料流讀取位元組，並將其寫入另一個資料流中。 (繼承來源 Stream)
CopyTo(Stream, Int32)	使用指定的緩衝區大小，從目前資料流讀取所有位元組，並將其寫入另一個資料流中。 (繼承來源 Stream)
CopyToAsync(Stream)	以非同步的方式從目前資料流讀取所有位元組，並將其寫入另一個資料流中。 (繼承來源 Stream)
CopyToAsync(Stream, CancellationToken)	使用指定的取消權杖，以非同步的方式從目前資料流讀取位元組，並將其寫入另一個資料流。 (繼承來源 Stream)
CopyToAsync(Stream, Int32)	使用指定的緩衝區大小，以非同步的方式從目前資料流讀取所有位元組，並將其寫入另一個資料流中。 (繼承來源 Stream)
CopyToAsync(Stream, Int32, CancellationToken)	使用指定的緩衝區大小和取消語彙基元，以非同步的方式從目前資料流讀取位元組，並將其寫入另一個資料流。 (繼承來源 Stream)
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
CreateWaitHandle()	已過時。 已過時。 配置 WaitHandle 物件。 (繼承來源 Stream)
Dispose()	釋放 Stream 所使用的所有資源。 (繼承來源 Stream)
Dispose(Boolean)	釋放 Stream 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Stream)
DisposeAsync()	以非同步方式釋放 Stream 使用的不受控資源。 (繼承來源 Stream)
EndRead(IAsyncResult)	等候暫止的非同步讀取完成。
EndRead(IAsyncResult)	等候暫止的非同步讀取完成。 (請考慮用 ReadAsync(Byte[], Int32, Int32) 替代。) (繼承來源 Stream)
EndWrite(IAsyncResult)	結束非同步的寫入作業。
EndWrite(IAsyncResult)	結束非同步的寫入作業。 (請考慮用 WriteAsync(Byte[], Int32, Int32) 替代。) (繼承來源 Stream)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	確認釋出資源，並在記憶體回收行程再利用 SqlFileStream 時執行其他清除作業。
Flush()	清除這個資料流的所有緩衝區，並造成所有緩衝資料都寫入基礎裝置。
FlushAsync()	以非同步的方式清除這個資料流的所有緩衝區，並造成所有緩衝資料都寫入基礎裝置。 (繼承來源 Stream)
FlushAsync(CancellationToken)	以非同步的方式清除這個資料流的所有緩衝區，造成所有緩衝資料都寫入基礎裝置，並且監視取消要求。 (繼承來源 Stream)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已過時。 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已過時。 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
ObjectInvariant()	已過時。 提供 Contract 的支援。 (繼承來源 Stream)
Read(Byte[], Int32, Int32)	從目前的資料流讀取位元組序列，並依讀取的位元組數將資料流中的位置往前移。
Read(Span<Byte>)	當在衍生類別中覆寫時，自目前資料流讀取一連串的位元組，並依所讀取的位元組數目進階資料流中的位置。 (繼承來源 Stream)
ReadAsync(Byte[], Int32, Int32)	以非同步的方式從目前的資料流讀取位元組序列，並依讀取的位元組數將資料流中的位置往前移。 (繼承來源 Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	以非同步的方式從目前資料流讀取一連串的位元組、依所讀取的位元組數目進階資料流中的位置，以及監視取消要求。 (繼承來源 Stream)
ReadAsync(Memory<Byte>, CancellationToken)	以非同步的方式從目前資料流讀取一連串的位元組、依所讀取的位元組數目進階資料流中的位置，以及監視取消要求。 (繼承來源 Stream)
ReadByte()	從資料流讀取一個位元組，並將資料流的位置推進一個位元組；如果在資料流末端，則傳回 -1。
ReadByte()	從資料流讀取一個位元組，並將資料流的位置推進一個位元組；如果在資料流末端，則傳回 -1。 (繼承來源 Stream)
Seek(Int64, SeekOrigin)	設定目前資料流位置。
SetLength(Int64)	設定目前資料流的長度。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Write(Byte[], Int32, Int32)	將位元組序列寫入至目前的資料流，並依寫入的位元組數將資料流中目前的位置往前移。
Write(ReadOnlySpan<Byte>)	在衍生類別中覆寫時，將一連串的位元組寫入目前的資料流，並且由這個資料流中目前的位置前移寫入的位元組數目。 (繼承來源 Stream)
WriteAsync(Byte[], Int32, Int32)	以非同步的方式將位元組序列寫入至目前的資料流，並依寫入的位元組數將資料流中目前的位置往前移。 (繼承來源 Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	以非同步的方式將一連串的位元組寫入目前的資料流，由這個資料流中目前的位置前移寫入的位元組數目，並且監視取消要求。 (繼承來源 Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	以非同步的方式將一連串的位元組寫入目前的資料流，由這個資料流中目前的位置前移寫入的位元組數目，並且監視取消要求。 (繼承來源 Stream)
WriteByte(Byte)	寫入一個位元組至資料流的目前位置，並將資料流位置推進一個位元組。
WriteByte(Byte)	寫入一個位元組至資料流的目前位置，並將資料流位置推進一個位元組。 (繼承來源 Stream)

擴充方法

CopyToAsync(Stream, PipeWriter, CancellationToken)	使用取消語彙基元，以非同步的方式從 Stream 讀取位元組，並將其寫入指定的 PipeWriter。
AsInputStream(Stream)	將適用於 Windows 市集應用程式的 .NET 中的受控資料流轉換成 Windows 執行階段中的輸入資料流。
AsOutputStream(Stream)	將適用於 Windows 市集應用程式的 .NET 中的受控資料流轉換成 Windows 執行階段中的輸出資料流。
AsRandomAccessStream(Stream)	將指定的資料流轉換為隨機存取資料流。

另請參閱

• FILESTREAM 資料
• SQL Server 資料類型對應 (ADO.NET)
• SQL Server 二進位和大量數值資料 (ADO.NET)