Sdílet prostřednictvím


TextWriter.WriteAsync Metoda

Definice

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
Zdroj:
TextWriter.cs
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);
[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

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

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

Atributy

Výjimky

buffer je null.

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

index nebo count je negativní.

Zapisovač textu se odstraní.

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é

Platí pro

WriteAsync(StringBuilder, CancellationToken)

Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
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

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

Výjimky

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

Platí pro

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
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

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

Výjimky

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Platí pro

WriteAsync(String)

Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
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);
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

Parametry

value
String

Řetězec určený pro zápis Pokud value je null, do textového streamu se nic nepíše.

Návraty

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

Atributy

Výjimky

Zapisovač textu se odstraní.

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é

Platí pro

WriteAsync(Char[])

Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
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);
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

Parametry

buffer
Char[]

Pole znaků pro zápis do textového streamu. Pokud buffer je null, nic se nepíše.

Návraty

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

Atributy

Výjimky

Zapisovač textu se odstraní.

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é

Platí pro

WriteAsync(Char)

Zdroj:
TextWriter.cs
Zdroj:
TextWriter.cs
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);
[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

Parametry

value
Char

Znak pro zápis do textového streamu.

Návraty

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

Atributy

Výjimky

Zapisovač textu se odstraní.

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é

Platí pro