Stream.Write 方法

定義

多載

Write(ReadOnlySpan<Byte>)

在衍生類別中覆寫時,將一連串的位元組寫入目前的資料流,並且由這個資料流中目前的位置前移寫入的位元組數目。

Write(Byte[], Int32, Int32)

在衍生類別中覆寫時,將一連串的位元組寫入目前的資料流,並且由這個資料流中目前的位置前移寫入的位元組數目。

Write(ReadOnlySpan<Byte>)

在衍生類別中覆寫時,將一連串的位元組寫入目前的資料流,並且由這個資料流中目前的位置前移寫入的位元組數目。

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)

在衍生類別中覆寫時,將一連串的位元組寫入目前的資料流,並且由這個資料流中目前的位置前移寫入的位元組數目。

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[]

位元組陣列。 此方法會從 buffer 複製 count 位元組到目前資料流。

offset
Int32

buffer 中以零起始的位元組位移,即開始將位元組複製到目前資料流的位置。

count
Int32

寫入目前資料流的位元組數目。

例外狀況

offsetcount 的總和大於緩衝區長度。

buffernull

offsetcount 為負。

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

資料流不支援寫入。

關閉資料流後呼叫了 Write(Byte[], Int32, Int32)

備註

CanWrite 可以使用屬性來判斷目前的實例是否支援寫入。 您 WriteAsync 可以使用方法,以非同步方式寫入目前的資料流程。

如果寫入作業成功,資料流程中的位置會依寫入的位元組數前進。 如果發生例外狀況,資料流程中的位置會維持不變。

另請參閱

適用於