TextWriter.WriteLineAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Asynchronně zapisuje data do textového streamu následovaný ukončovacím znakem řádku.

Přetížení

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapíše textovou reprezentaci oblasti paměti znaků do textového streamu následovaný ukončovacím znakem.
WriteLineAsync(String)	Asynchronně zapíše řetězec do textového streamu následovaný ukončovacím znakem řádku.
WriteLineAsync(Char[])	Asynchronně zapíše pole znaků do textového streamu následované ukončovacím znakem řádku.
WriteLineAsync(Char[], Int32, Int32)	Asynchronně zapíše do textového datového proudu podadresu znaků následovanou ukončovacím znakem řádku.
WriteLineAsync()	Asynchronně zapíše ukončovač řádků do textového streamu.
WriteLineAsync(StringBuilder, CancellationToken)	Asynchronně zapíše textovou reprezentaci tvůrce řetězců do textového streamu následovaný ukončovacím znakem řádku.
WriteLineAsync(Char)	Asynchronně zapíše znak do textového streamu následovaný ukončovacím znakem řádku.

Poznámky

Třída TextWriter je abstraktní třída. Proto se v kódu nevytvořuje instance. Příklad použití metody najdete v WriteLineAsyncStreamWriter.WriteLineAsync metodě .

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Zdroj:

TextWriter.cs

Asynchronně zapíše textovou reprezentaci oblasti paměti znaků do textového streamu následovaný ukončovacím znakem.

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

Parametry

buffer

ReadOnlyMemory<Char>

Oblast paměti znaků, která se má zapisovat do textového streamu.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

WriteLineAsync(String)

Zdroj:

TextWriter.cs

Asynchronně zapíše řetězec do textového streamu následovaný ukončovacím znakem řádku.

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

Parametry

value

String

Řetězec určený pro zápis Pokud je nullhodnota , zapíše se pouze ukončovací znak řádku.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ObjectDisposedException

Zapisovač textu je odstraněn.

InvalidOperationException

Zapisovač textu je aktuálně používán předchozí operací zápisu.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Třída TextWriter je abstraktní třída. Proto ji v kódu nevytvořujete. Příklad použití WriteLineAsync metody najdete v StreamWriter.WriteLineAsync metodě .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine(String).

Viz také

• WriteLineAsync(String)
• WriteLineAsync(String)

WriteLineAsync(Char[])

Zdroj:

TextWriter.cs

Asynchronně zapíše pole znaků do textového streamu následované ukončovacím znakem řádku.

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

Parametry

buffer

Char[]

Pole znaků pro zápis do textového streamu. Pokud je nullpole znaků , zapíše se pouze ukončovací znak řádku.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ObjectDisposedException

Zapisovač textu je odstraněn.

InvalidOperationException

Zapisovač textu je aktuálně používán předchozí operací zápisu.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine(Char[]).

Viz také

• StreamWriter
• StringWriter

WriteLineAsync(Char[], Int32, Int32)

Zdroj:

TextWriter.cs

Asynchronně zapíše do textového datového proudu podadresu znaků následovanou ukončovacím znakem řádku.

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

Parametry

buffer

Char[]

Pole znaků, ze které chcete zapisovat data.

index

Int32

Pozice znaku ve vyrovnávací paměti, ve které se mají začít načítat data.

count

Int32

Počet znaků k zápisu.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ArgumentNullException

buffer je null.

ArgumentException

count Plus index je větší než délka vyrovnávací paměti.

ArgumentOutOfRangeException

index nebo count je negativní.

ObjectDisposedException

Zapisovač textu je odstraněn.

InvalidOperationException

Zapisovač textu je aktuálně používán předchozí operací zápisu.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine(Char[], Int32, Int32).

Viz také

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

WriteLineAsync()

Zdroj:

TextWriter.cs

Asynchronně zapíše ukončovač řádků do textového streamu.

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

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ObjectDisposedException

Zapisovač textu je odstraněn.

InvalidOperationException

Zapisovač textu je aktuálně používán předchozí operací zápisu.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine().

Viz také

• WriteLineAsync()

WriteLineAsync(StringBuilder, CancellationToken)

Zdroj:

TextWriter.cs

Asynchronně zapíše textovou reprezentaci tvůrce řetězců do textového streamu následovaný ukončovacím znakem řádku.

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

Parametry

value

StringBuilder

Řetězec, jako tvůrce řetězců, pro zápis do textového streamu.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine(StringBuilder).

WriteLineAsync(Char)

Zdroj:

TextWriter.cs

Asynchronně zapíše znak do textového streamu následovaný ukončovacím znakem řádku.

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

Parametry

value

Char

Znak pro zápis do textového streamu.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ObjectDisposedException

Zapisovač textu je odstraněn.

InvalidOperationException

Zapisovač textu je aktuálně používán předchozí operací zápisu.

Poznámky

Ukončovací znak řádku je definován polem CoreNewLine .

Třída TextWriter je abstraktní třída. Proto ji v kódu nevytvořujete. Příklad použití WriteLineAsync metody najdete v StreamWriter.WriteLineAsync metodě .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteLine(Char).

Viz také

• WriteLineAsync(Char)
• WriteLineAsync(Char)