TextWriter.WriteAsync Metoda

Definicja

Zapisuje dane w strumieniu tekstowym asynchronicznie.

Przeciążenia

WriteAsync(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.

WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów w strumieniu tekstowym.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje obszar pamięci znaków w strumieniu tekstu.

WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.

WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.

WriteAsync(Char)

Zapisuje znak w strumieniu tekstowym asynchronicznie.

WriteAsync(Char[], Int32, Int32)

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.

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[]

Tablica znaków do zapisu danych.

index
Int32

Pozycja znaku w buforze, w którym należy rozpocząć pobieranie danych.

count
Int32

Liczba znaków, jaka ma zostać zapisana.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Atrybuty

Wyjątki

buffer to null.

Znak index plus count jest większy niż długość buforu.

index lub count jest ujemny.

Moduł zapisujący tekstu jest usuwany.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.

Uwagi

Klasa TextWriter jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia WriteAsync metody , zobacz metodę StreamWriter.WriteAsync .

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(Char[], Int32, Int32)usługę .

Zobacz też

Dotyczy

WriteAsync(StringBuilder, CancellationToken)

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Asynchronicznie zapisuje konstruktora ciągów w strumieniu tekstowym.

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

Ciąg jako konstruktor ciągów do zapisu w strumieniu tekstowym.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda jest równoważna wywołaniu WriteAsync(stringBuilder.ToString())metody , jednak używa StringBuilder.GetChunks() metody , aby uniknąć tworzenia ciągu pośredniego.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(StringBuilder)usługę .

Dotyczy

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Asynchronicznie zapisuje obszar pamięci znaków w strumieniu tekstu.

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>

Obszar pamięci znaków do zapisu w strumieniu tekstowym.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Wyjątki

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

WriteAsync(String)

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.

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

Ciąg do zapisu. Jeśli value parametr ma nullwartość , nic nie jest zapisywane w strumieniu tekstowym.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.

Uwagi

Klasa TextWriter jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia WriteAsync metody , zobacz metodę StreamWriter.WriteAsync .

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(String)usługę .

Zobacz też

Dotyczy

WriteAsync(Char[])

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.

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[]

Tablica znaków do zapisu w strumieniu tekstowym. Jeśli buffer parametr ma nullwartość , nic nie jest zapisywane.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.

Uwagi

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(Char[])usługę .

Zobacz też

Dotyczy

WriteAsync(Char)

Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Zapisuje znak w strumieniu tekstowym asynchronicznie.

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 do zapisu w strumieniu tekstu.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.

Atrybuty

Wyjątki

Moduł zapisujący tekstu jest usuwany.

Moduł zapisujący tekstu jest aktualnie używany przez poprzednią operację zapisu.

Uwagi

Klasa TextWriter jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia WriteAsync metody , zobacz metodę StreamWriter.WriteAsync .

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Write(Char)usługę .

Zobacz też

Dotyczy