TextWriter.WriteAsync Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zapisuje data do textového streamu asynchronně.

Přetížení

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 znakové paměti do textového streamu.
WriteAsync(String)	Zapíše řetězec do textového streamu asynchronně.
WriteAsync(Char[])	Zapíše pole znaků do textového streamu asynchronně.
WriteAsync(Char)	Zapíše 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ů, ze které se mají 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

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

ArgumentOutOfRangeException

index nebo count je negativní.

ObjectDisposedException

Zapisovač textu se odstraní.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem 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ů, 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 se uloží 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, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(StringBuilder).

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Zdroj:

TextWriter.cs

Asynchronně zapíše oblast znakové paměti 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ů, 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 se uloží do vrácené úlohy.

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 určený pro zápis Pokud value je null, do textového streamu se nic nepíše.

Návraty

Task

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

Výjimky

ObjectDisposedException

Zapisovač textu se odstraní.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem 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 je null, nic se nepíše.

Návraty

Task

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

Výjimky

ObjectDisposedException

Zapisovač textu se odstraní.

InvalidOperationException

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

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(Char[]).

Viz také

• StreamWriter
• StringWriter

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 se odstraní.

InvalidOperationException

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

Poznámky

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(Char).

Viz také

• WriteAsync(Char)
• WriteAsync(Char)