Stream 類別

定義

public ref class Stream abstract : IDisposable

public ref class Stream abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class Stream abstract : MarshalByRefObject, IDisposable

public abstract class Stream : IDisposable

public abstract class Stream : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Stream : MarshalByRefObject, IDisposable

type Stream = class
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class Stream
Implements IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IDisposable

繼承

Object

Stream

繼承

Object

MarshalByRefObject

Stream

衍生

Microsoft.Extensions.AI.HostedFileDownloadStream

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

更多…

屬性

SerializableAttribute ComVisibleAttribute

實作

IDisposable IAsyncDisposable

範例

以下範例示範如何利用兩個 FileStream 物件非同步地將檔案從一個目錄複製到另一個目錄。 類別 FileStream 衍生自 Stream 類別。 請注意， Click 控件的 Button 事件處理程式會以 async 修飾詞標示，因為它會呼叫異步方法。

using System;
using System.Threading.Tasks;
using System.Windows;
using System.IO;

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            string StartDirectory = @"c:\Users\exampleuser\start";
            string EndDirectory = @"c:\Users\exampleuser\end";

            foreach (string filename in Directory.EnumerateFiles(StartDirectory))
            {
                using (FileStream SourceStream = File.Open(filename, FileMode.Open))
                {
                    using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
                    {
                        await SourceStream.CopyToAsync(DestinationStream);
                    }
                }
            }
        }
    }
}

Imports System.IO

Class MainWindow

    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim StartDirectory As String = "c:\Users\exampleuser\start"
        Dim EndDirectory As String = "c:\Users\exampleuser\end"

        For Each filename As String In Directory.EnumerateFiles(StartDirectory)
            Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
                Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
                    Await SourceStream.CopyToAsync(DestinationStream)
                End Using

            End Using
        Next
    End Sub

End Class

備註

Stream 是所有串流的抽象基底類別。 數據流是位元組序列的抽象概念，例如檔案、輸入/輸出裝置、進程間通訊管道或 TCP/IP 套接字。 這個 Stream 類別及其衍生類別提供了這些不同輸入與輸出類型的通用視圖，並將程式設計師與作業系統及底層裝置的具體細節隔離開來。

串流涉及三個基本操作：

• 您可以從數據流讀取。 讀取是將數據從數據流傳輸到數據結構，例如位元組陣列。

• 您可以寫入資料流。 寫入是將數據從數據結構傳輸到數據流。

• 串流可以支持搜尋。 搜尋是指查詢和修改數據流中目前的位置。 搜尋功能取決於數據流擁有的備份儲存區類型。 例如，網路數據流沒有目前位置的統一概念，因此通常不支持搜尋。

一些較常用的繼承 流 Stream 有 FileStream、 MemoryStream和 。

視基礎數據源或存放庫而定，數據流可能只支援其中一些功能。 你可以利用CanRead類別的 CanWrite 、 、 CanSeekStream 和 屬性來查詢串流的能力。

Read與Write方法以多種格式讀寫資料。 對於支援尋址的串流，請使用 Seek and SetLength 方法和 and PositionLength 屬性來查詢並修改串流目前的位置與長度。

此類型會實作 IDisposable 介面。 當你用完型別後，應該直接（呼叫其 Dispose 方法）或間接（用語言結構，例如 using C# 中）處理它。 欲了解更多資訊，請參閱 「使用實作 IDisposable 的物件」。

丟棄 Stream 物件會清除所有緩衝資料，基本上是幫你呼叫這個 Flush 方法。 Dispose 同時也會釋放作業系統資源，例如檔案處理器、網路連線，或用於任何內部緩衝的記憶體。 此 BufferedStream 類別提供將緩衝串流包裹於另一串流以提升讀寫效能的能力。

從 .NET Framework 4.5 開始，該 Stream 類別包含非同步方法以簡化非同步操作。 非同步方法名稱中包含 Async ，例如 ReadAsync、 WriteAsync、 CopyToAsync和 FlushAsync。 這些方法可讓您執行耗用大量資源的 I/O 作業，而不會封鎖主要線程。 在 Windows 8.x 市集應用程式或傳統型應用程式中，此效能考慮特別重要，其中耗時的串流作業可能會封鎖 UI 線程，並讓應用程式看起來好像無法運作。 非同步方法與 async 和 await 關鍵字搭配使用 Visual Basic 和 C# 中。

當用於 Windows 8.x 商店應用程式時，包含 Stream 兩種擴充方法： AsInputStream 和 AsOutputStream。 這些方法將物件轉換 Stream 成 Windows 執行時的串流。 你也可以在 Stream Windows 執行時使用和AsStreamForRead方法，將串流轉換成AsStreamForWrite物件。 欲了解更多資訊，請參閱 《如何：在 .NET Framework 串流與 Windows 執行環境串流間轉換

某些數據流實作會執行基礎數據的本機緩衝，以改善效能。 對於這類資料流，你可以使用 Flush or FlushAsync 方法清除所有內部緩衝區，並確保所有資料都已寫入底層資料來源或儲存庫。

如果你需要一個沒有後備儲存的串流（也稱為位元桶），可以使用欄位 Null 來擷取專為此目的設計的串流實例。

給實施者的注意事項

當你實作導Stream出類別時，必須提供 和 Read(Byte[], Int32, Int32) 方法的實作Write(Byte[], Int32, Int32)。 非同步方法ReadAsync(Byte[], Int32, Int32)、、、WriteAsync(Byte[], Int32, Int32)並使用同步方法CopyToAsync(Stream)及其Read(Byte[], Int32, Int32)實作。 Write(Byte[], Int32, Int32) 因此，你的 和 Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32) 實作會與非同步方法正常運作。 預設的 和 實作ReadByte()WriteByte(Byte)建立一個新的單元素位元組陣列，然後呼叫你的實作 Read(Byte[], Int32, Int32)Write(Byte[], Int32, Int32)和 。 當你從 推導出 Stream時，我們建議你覆寫這些方法來存取你的內部緩衝區（如果有的話），以大幅提升效能。 你還必須提供 、 CanRead、 CanSeekCanWriteFlush()LengthPositionSeek(Int64, SeekOrigin)的實作。SetLength(Int64)

不要覆寫方法， Close() 而是把所有 Stream 清理邏輯都放進方法裡 Dispose(Boolean) 。 欲了解更多資訊，請參閱 「實施處置方法」。

另請參閱

• FileStream
• MemoryStream
• BufferedStream
• 檔案和數據流 I/O
• 如何：在 .NET Framework 串流與 Windows 執行環境串流之間轉換