TextWriter.WriteAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zapisuje data do textového streamu asynchronně.

Přetížení

Name	Description
WriteAsync(Char[], Int32, Int32)	Zapíše dílčí pole znaků do textového streamu asynchronně.
WriteAsync(StringBuilder, CancellationToken)	Asynchronně zapíše tvůrce řetězců do textového streamu.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapíše oblast paměti znaků do textového streamu.
WriteAsync(Char)	Zapíše znak do textového streamu asynchronně.
WriteAsync(String)	Zapíše řetězec do textového streamu asynchronně.
WriteAsync(Char[])	Zapíše pole znaků do textového streamu asynchronně.

WriteAsync(Char[], Int32, Int32)

Zdroj:

TextWriter.cs

Zapíše dílčí pole znaků do textového streamu asynchronně.

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);

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

Parametry

buffer

Char[]

Pole znaků pro zápis dat z.

index

Int32

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

count

Int32

Počet znaků, které se mají napsat.

Návraty

Task

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

Výjimky

ArgumentNullException

buffer je null.

ArgumentException

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

ArgumentOutOfRangeException

index nebo count je negativní.

ObjectDisposedException

Zapisovač textu je uvolněn.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(Char[], Int32, Int32).

Viz také

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

WriteAsync(StringBuilder, CancellationToken)

Zdroj:

TextWriter.cs

Asynchronně zapíše tvůrce řetězců do textového streamu.

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

Parametry

value

StringBuilder

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

cancellationToken

CancellationToken

Token pro monitorování žádostí 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 do vrácené úlohy.

Poznámky

Tato metoda je ekvivalentní volání WriteAsync(stringBuilder.ToString()), ale používá metodu StringBuilder.GetChunks() , aby se zabránilo vytvoření zprostředkujícího řetězce.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(StringBuilder).

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Zdroj:

TextWriter.cs

Asynchronně zapíše oblast paměti znaků do textového streamu.

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

Parametry

buffer

ReadOnlyMemory<Char>

Oblast paměti znaků pro zápis do textového streamu.

cancellationToken

CancellationToken

Token pro monitorování žádostí 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 do vrácené úlohy.

WriteAsync(Char)

Zdroj:

TextWriter.cs

Zapíše znak do textového streamu asynchronně.

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

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

Public Overridable Function WriteAsync (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 uvolněn.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(Char).

Viz také

• WriteAsync(Char)
• WriteAsync(Char)

WriteAsync(String)

Zdroj:

TextWriter.cs

Zapíše řetězec do textového streamu asynchronně.

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

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

Public Overridable Function WriteAsync (value As String) As Task

Parametry

value

String

Řetězec k zápisu. Pokud value je null, nic není zapsáno do textového streamu.

Návraty

Task

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

Výjimky

ObjectDisposedException

Zapisovač textu je uvolněn.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(String).

Viz také

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

Zdroj:

TextWriter.cs

Zapíše pole znaků do textového streamu asynchronně.

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

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

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

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

Parametry

buffer

Char[]

Pole znaků pro zápis do textového streamu. Pokud buffer ano null, nic není napsané.

Návraty

Task

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

Výjimky

ObjectDisposedException

Zapisovač textu je uvolněn.

InvalidOperationException

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

Poznámky

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(Char[]).

Viz také

• StreamWriter
• StringWriter