TextWriter.WriteAsync Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.IO.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Task

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

Atributy: ComVisibleAttribute

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 WriteAsync StreamWriter.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

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.

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

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.

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

Task

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

Atributy: ComVisibleAttribute

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 WriteAsync StreamWriter.WriteAsync metodě .

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

Task

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

Atributy: ComVisibleAttribute

Výjimky

ObjectDisposedException

Zapisovač textu se odstraní.

InvalidOperationException

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

Poznámky

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

Task

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

Atributy: ComVisibleAttribute

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 WriteAsync StreamWriter.WriteAsync metodě .

Viz také

Platí pro

Sdílet prostřednictvím

TextWriter.WriteAsync Metoda

Definice

Přetížení

WriteAsync(Char[], Int32, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

WriteAsync(StringBuilder, CancellationToken)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Parametry

Návraty

Výjimky

Platí pro

WriteAsync(String)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

WriteAsync(Char[])

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

WriteAsync(Char)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

Další materiály