TextWriter.WriteLineAsync 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

以非同步方式將資料寫入文字資料流，後接行結束字元。

多載

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	以非同步方式將字元記憶體區域的文字表示寫入文字資料流，後接行結束字元。
WriteLineAsync(String)	以非同步方式將字串寫入文字資料流，後接行結束字元。
WriteLineAsync(Char[])	以非同步方式將字元的陣列寫入文字資料流，後接行結束字元。
WriteLineAsync(Char[], Int32, Int32)	以非同步方式將字元的子陣列寫入文字資料流，後接行結束字元。
WriteLineAsync()	以非同步方式將行結束字元寫入文字資料流。
WriteLineAsync(StringBuilder, CancellationToken)	以非同步方式將字串產生器的文字表示寫入文字資料流，後接行結束字元。
WriteLineAsync(Char)	以非同步方式將字元寫入文字資料流，後接行結束字元。

備註

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

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

來源:

TextWriter.cs

以非同步方式將字元記憶體區域的文字表示寫入文字資料流，後接行結束字元。

public virtual System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

參數

buffer

ReadOnlyMemory<Char>

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

cancellationToken

CancellationToken

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

傳回

Task

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

例外狀況

OperationCanceledException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

WriteLineAsync(String)

來源:

TextWriter.cs

以非同步方式將字串寫入文字資料流，後接行結束字元。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteLineAsync (string? value);

abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (value As String) As Task

參數

value

String

要寫入的字串。 如果值為 null，則只會寫入行結束字元。

傳回

Task

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

例外狀況

ObjectDisposedException

文字寫入器已處置。

InvalidOperationException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

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

另請參閱

• WriteLineAsync(String)
• WriteLineAsync(String)

WriteLineAsync(Char[])

來源:

TextWriter.cs

以非同步方式將字元的陣列寫入文字資料流，後接行結束字元。

public:
 System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteLineAsync (char[]? buffer);

member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteLineAsync (buffer As Char()) As Task

參數

buffer

Char[]

要寫入到文字資料流的字元陣列。 如果字元陣列是 null，則只有行結束字元會被寫入。

傳回

Task

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

例外狀況

ObjectDisposedException

文字寫入器已處置。

InvalidOperationException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

另請參閱

• StreamWriter
• StringWriter

WriteLineAsync(Char[], Int32, Int32)

來源:

TextWriter.cs

以非同步方式將字元的子陣列寫入文字資料流，後接行結束字元。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

參數

buffer

Char[]

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

index

Int32

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

count

Int32

要寫入的字元數。

傳回

Task

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

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentException

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

ArgumentOutOfRangeException

index 或 count 為負。

ObjectDisposedException

文字寫入器已處置。

InvalidOperationException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

另請參閱

• WriteLineAsync(Char[], Int32, Int32)
• WriteLineAsync(Char[], Int32, Int32)

WriteLineAsync()

來源:

TextWriter.cs

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

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync();

public virtual System.Threading.Tasks.Task WriteLineAsync ();

abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync () As Task

傳回

Task

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

例外狀況

ObjectDisposedException

文字寫入器已處置。

InvalidOperationException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

另請參閱

• WriteLineAsync()

WriteLineAsync(StringBuilder, CancellationToken)

來源:

TextWriter.cs

以非同步方式將字串產生器的文字表示寫入文字資料流，後接行結束字元。

public virtual System.Threading.Tasks.Task WriteLineAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

參數

value

StringBuilder

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

cancellationToken

CancellationToken

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

傳回

Task

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

例外狀況

OperationCanceledException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

WriteLineAsync(Char)

來源:

TextWriter.cs

以非同步方式將字元寫入文字資料流，後接行結束字元。

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(char value);

public virtual System.Threading.Tasks.Task WriteLineAsync (char value);

abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (value As Char) As Task

參數

value

Char

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

傳回

Task

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

例外狀況

ObjectDisposedException

文字寫入器已處置。

InvalidOperationException

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

備註

行結束字元是由 CoreNewLine 欄位所定義。

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

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

另請參閱

• WriteLineAsync(Char)
• WriteLineAsync(Char)