共用方式為


TextWriter.WriteAsync 方法

定義

以非同步方式將資料寫入文字資料流。

多載

WriteAsync(Char[], Int32, Int32)

以非同步方式將字元的子陣列寫入文字資料流。

WriteAsync(StringBuilder, CancellationToken)

以非同步方式將字串產生器寫入文字資料流。

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

以非同步方式將字元記憶體區域寫入文字資料流。

WriteAsync(String)

以非同步方式將字串寫入至文字資料流。

WriteAsync(Char[])

以非同步方式將字元陣列寫入文字資料流。

WriteAsync(Char)

以非同步方式將字元寫入文字資料流。

WriteAsync(Char[], Int32, Int32)

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字元的子陣列寫入文字資料流。

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);
abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

參數

buffer
Char[]

資料寫入來源的字元陣列。

index
Int32

緩衝區中要開始擷取資料的字元位置。

count
Int32

要寫入的字元數。

傳回

表示非同步寫入作業的工作。

屬性

例外狀況

buffernull

index 加上 count 大於緩衝區長度。

indexcount 為負。

文字寫入器已處置。

文字寫入器目前由先前寫入作業所使用。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 方法的 WriteAsync 範例,請參閱 StreamWriter.WriteAsync 方法。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 Write(Char[], Int32, Int32)例外狀況。

另請參閱

適用於

WriteAsync(StringBuilder, CancellationToken)

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字串產生器寫入文字資料流。

public virtual System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

參數

value
StringBuilder

作為字串產生器的字串,用於寫入文字資料流。

cancellationToken
CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None

傳回

表示非同步寫入作業的工作。

例外狀況

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法相當於呼叫 WriteAsync(stringBuilder.ToString()),不過它會使用 StringBuilder.GetChunks() 方法來避免建立中繼字串。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 Write(StringBuilder)例外狀況。

適用於

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字元記憶體區域寫入文字資料流。

public virtual System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

參數

buffer
ReadOnlyMemory<Char>

要寫入文字資料流的字元記憶體區域。

cancellationToken
CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None

傳回

表示非同步寫入作業的工作。

例外狀況

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

WriteAsync(String)

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字串寫入至文字資料流。

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);
public virtual System.Threading.Tasks.Task WriteAsync (string value);
public virtual System.Threading.Tasks.Task WriteAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteAsync (string value);
abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (value As String) As Task

參數

value
String

要寫入的字串。 如果 valuenull,不寫入任何字串到文字資料流。

傳回

表示非同步寫入作業的工作。

屬性

例外狀況

文字寫入器已處置。

文字寫入器目前由先前寫入作業所使用。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 方法的 WriteAsync 範例,請參閱 StreamWriter.WriteAsync 方法。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 Write(String)例外狀況。

另請參閱

適用於

WriteAsync(Char[])

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字元陣列寫入文字資料流。

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
public System.Threading.Tasks.Task WriteAsync (char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
Public Function WriteAsync (buffer As Char()) As Task

參數

buffer
Char[]

要寫入到文字資料流的字元陣列。 如果 buffernull,則不寫入任何資料。

傳回

表示非同步寫入作業的工作。

屬性

例外狀況

文字寫入器已處置。

文字寫入器目前由先前寫入作業所使用。

備註

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 Write(Char[])例外狀況。

另請參閱

適用於

WriteAsync(Char)

來源:
TextWriter.cs
來源:
TextWriter.cs
來源:
TextWriter.cs

以非同步方式將字元寫入文字資料流。

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);
public virtual System.Threading.Tasks.Task WriteAsync (char value);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteAsync (char value);
abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task
Public Overridable Function WriteAsync (value As Char) As Task

參數

value
Char

要寫入到文字資料流的字元。

傳回

表示非同步寫入作業的工作。

屬性

例外狀況

文字寫入器已處置。

文字寫入器目前由先前寫入作業所使用。

備註

類別是抽象類別, 因此,您的程式碼中不必將它執行個體化。 如需使用 方法的 WriteAsync 範例,請參閱 StreamWriter.WriteAsync 方法。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 Write(Char)例外狀況。

另請參閱

適用於