Stream.Write 方法

定義

命名空間:

System.IO

組件:

netstandard.dll, System.Runtime.dll

多載

名稱	Description
Write(ReadOnlySpan<Byte>)	當在衍生類別中覆寫時，會寫入一串位元組到目前串流，並依照寫入的位元組數將該串流中的當前位置往前推進。
Write(Byte[], Int32, Int32)	當在衍生類別中覆寫時，會寫入一串位元組到目前串流，並依照寫入的位元組數將該串流中的當前位置往前推進。

Write(ReadOnlySpan<Byte>)

來源:

Stream.cs

當在衍生類別中覆寫時，會寫入一串位元組到目前串流，並依照寫入的位元組數將該串流中的當前位置往前推進。

public:
 virtual void Write(ReadOnlySpan<System::Byte> buffer);

public virtual void Write(ReadOnlySpan<byte> buffer);

abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))

參數

buffer

ReadOnlySpan<Byte>

一個記憶區域。 此方法會將該區域的內容複製到目前的串流中。

備註

利用該 CanWrite 屬性判斷目前實例是否支援寫入。 使用該 WriteAsync 方法非同步寫入目前串流。

若寫入成功，串流中的位置會依照寫入的位元組數前進。 若發生例外，串流中的位置保持不變。

Write(Byte[], Int32, Int32)

來源:

Stream.cs

當在衍生類別中覆寫時，會寫入一串位元組到目前串流，並依照寫入的位元組數將該串流中的當前位置往前推進。

public:
 abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public abstract void Write(byte[] buffer, int offset, int count);

abstract member Write : byte[] * int * int -> unit

Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)

參數

buffer

Byte[]

位元組陣列。 此方法將 count 位元組從 複製 buffer 到目前串流。

offset

Int32

以零為基礎的位元組偏移量 buffer ，從哪裡開始將位元組複製到當前串流。

count

Int32

目前串流要寫入的位元組數。

例外狀況

ArgumentException

和 count 的offset和大於緩衝區長度。

ArgumentNullException

buffer 為 null。

ArgumentOutOfRangeException

offset 或 count 是陰性。

IOException

發生 I/O 錯誤，例如找不到指定的檔案。

NotSupportedException

該課程不支援寫作。

ObjectDisposedException

Write(Byte[], Int32, Int32) 在溪流關閉後被叫停。

備註

利用該 CanWrite 屬性判斷目前實例是否支援寫入。 使用該 WriteAsync 方法非同步寫入目前串流。

若寫入成功，串流中的位置會依照寫入的位元組數前進。 若發生例外，串流中的位置保持不變。

另請參閱

• 檔案和數據流 I/O
• 如何：從檔案讀取文字
• 如何：將文字寫入檔案