TextWriter.WriteLineAsync Metoda

Definicja

Namespace:

System.IO

Zestawów:

netstandard.dll, System.Runtime.dll

Asynchronicznie zapisuje dane w strumieniu tekstowym, a następnie terminator wiersza.

Przeciążenia

Nazwa	Opis
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaków w strumieniu tekstowym, a następnie terminator wiersza.
WriteLineAsync(StringBuilder, CancellationToken)	Asynchronicznie zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, a następnie terminator wiersza.
WriteLineAsync(Char[])	Asynchronicznie zapisuje tablicę znaków w strumieniu tekstowym, a następnie terminator wiersza.
WriteLineAsync(Char)	Asynchronicznie zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLineAsync()	Asynchronicznie zapisuje terminator wiersza w strumieniu tekstowym.
WriteLineAsync(String)	Asynchronicznie zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLineAsync(Char[], Int32, Int32)	Asynchronicznie zapisuje podarraj znaków w strumieniu tekstowym, a następnie terminator wiersza.

Uwagi

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

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Źródło:

TextWriter.cs

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaków w strumieniu tekstowym, a następnie terminator wiersza.

public virtual System.Threading.Tasks.Task WriteLineAsync(ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametry

buffer

ReadOnlyMemory<Char>

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

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Domyślna wartość to None.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

OperationCanceledException

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

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

WriteLineAsync(StringBuilder, CancellationToken)

Źródło:

TextWriter.cs

Asynchronicznie zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, a następnie terminator wiersza.

public virtual System.Threading.Tasks.Task WriteLineAsync(System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (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. Domyślna wartość to None.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

OperationCanceledException

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

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine(StringBuilder).

WriteLineAsync(Char[])

Źródło:

TextWriter.cs

Asynchronicznie zapisuje tablicę znaków w strumieniu tekstowym, a następnie terminator wiersza.

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

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

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

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

Parametry

buffer

Char[]

Tablica znaków do zapisu w strumieniu tekstowym. Jeśli tablica znaków to null, zapisywany jest tylko terminator wiersza.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ObjectDisposedException

Składnik zapisywania tekstu jest usuwany.

InvalidOperationException

Składnik zapisywania tekstu jest obecnie używany przez poprzednią operację zapisu.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine(Char[]).

Zobacz także

• StreamWriter
• StringWriter

WriteLineAsync(Char)

Źródło:

TextWriter.cs

Asynchronicznie zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.

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

public virtual System.Threading.Tasks.Task WriteLineAsync(char value);

abstract member WriteLineAsync : char -> System.Threading.Tasks.Task
override this.WriteLineAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (value As Char) As Task

Parametry

value

Char

Znak do zapisu w strumieniu tekstowym.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ObjectDisposedException

Składnik zapisywania tekstu jest usuwany.

InvalidOperationException

Składnik zapisywania tekstu jest obecnie używany przez poprzednią operację zapisu.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

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

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine(Char).

Zobacz także

• WriteLineAsync(Char)
• WriteLineAsync(Char)

WriteLineAsync()

Źródło:

TextWriter.cs

Asynchronicznie zapisuje terminator wiersza w strumieniu tekstowym.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync();

public virtual System.Threading.Tasks.Task WriteLineAsync();

abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync () As Task

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ObjectDisposedException

Składnik zapisywania tekstu jest usuwany.

InvalidOperationException

Składnik zapisywania tekstu jest obecnie używany przez poprzednią operację zapisu.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine().

Zobacz także

• WriteLineAsync()

WriteLineAsync(String)

Źródło:

TextWriter.cs

Asynchronicznie zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.

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

public virtual System.Threading.Tasks.Task WriteLineAsync(string? value);

abstract member WriteLineAsync : string -> System.Threading.Tasks.Task
override this.WriteLineAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (value As String) As Task

Parametry

value

String

Ciąg do zapisania. Jeśli wartość to null, zapisywany jest tylko terminator wiersza.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ObjectDisposedException

Składnik zapisywania tekstu jest usuwany.

InvalidOperationException

Składnik zapisywania tekstu jest obecnie używany przez poprzednią operację zapisu.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

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

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine(String).

Zobacz także

• WriteLineAsync(String)
• WriteLineAsync(String)

WriteLineAsync(Char[], Int32, Int32)

Źródło:

TextWriter.cs

Asynchronicznie zapisuje podarraj znaków w strumieniu tekstowym, a następnie terminator wiersza.

public:
 virtual System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task WriteLineAsync(char[] buffer, int index, int count);

abstract member WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteLineAsync (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 do zapisania.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ArgumentNullException

Parametr buffer ma wartość null.

ArgumentException

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

ArgumentOutOfRangeException

index lub count jest ujemny.

ObjectDisposedException

Składnik zapisywania tekstu jest usuwany.

InvalidOperationException

Składnik zapisywania tekstu jest obecnie używany przez poprzednią operację zapisu.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteLine(Char[], Int32, Int32).

Zobacz także

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