TextWriter.WriteLineAsync Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Grava dados no fluxo de texto de forma assíncrona, seguidos por um terminador de linha.

Sobrecargas

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Grava de forma assíncrona a representação de texto de uma região da memória do caractere no fluxo de texto, seguida por um terminador de linha.
WriteLineAsync(String)	Grava de forma assíncrona uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.
WriteLineAsync(Char[])	Grava de forma assíncrona uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.
WriteLineAsync(Char[], Int32, Int32)	Grava de forma assíncrona uma submatriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.
WriteLineAsync()	Grava de forma assíncrona um terminador de linha no fluxo de texto.
WriteLineAsync(StringBuilder, CancellationToken)	Grava de forma assíncrona a representação de texto de um construtor de cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.
WriteLineAsync(Char)	Grava de forma assíncrona um caractere no fluxo de texto, seguido por um terminador de linha.

Comentários

A classe TextWriter é uma classe abstrata. Portanto, você não cria uma instância dele em seu código. Para obter um exemplo de como usar o WriteLineAsync método , consulte o StreamWriter.WriteLineAsync método .

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Origem:

TextWriter.cs

Grava de forma assíncrona a representação de texto de uma região da memória do caractere no fluxo de texto, seguida por um terminador de linha.

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

Parâmetros

buffer

ReadOnlyMemory<Char>

A região da memória do caractere a ser gravado no fluxo de texto.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

WriteLineAsync(String)

Origem:

TextWriter.cs

Grava de forma assíncrona uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.

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

Parâmetros

value

String

A cadeia de caracteres a ser gravada. Se o valor for null, somente um terminador de linha será gravado.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

ObjectDisposedException

O gravador de texto é descartado.

InvalidOperationException

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

A classe TextWriter é uma classe abstrata. Portanto, você não instanciá-lo em seu código. Para obter um exemplo de como usar o WriteLineAsync método , consulte o StreamWriter.WriteLineAsync método .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine(String).

Confira também

• WriteLineAsync(String)
• WriteLineAsync(String)

WriteLineAsync(Char[])

Origem:

TextWriter.cs

Grava de forma assíncrona uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.

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

Parâmetros

buffer

Char[]

A matriz de caracteres a ser gravada no fluxo de texto. Se a matriz de caracteres for null, somente o terminador de linha será gravado.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

ObjectDisposedException

O gravador de texto é descartado.

InvalidOperationException

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine(Char[]).

Confira também

• StreamWriter
• StringWriter

WriteLineAsync(Char[], Int32, Int32)

Origem:

TextWriter.cs

Grava de forma assíncrona uma submatriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.

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

Parâmetros

buffer

Char[]

A matriz de caracteres da qual os dados serão gravados.

index

Int32

A posição do caractere no buffer em que iniciar a recuperação de dados.

count

Int32

O número de caracteres a serem gravados.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O index mais count é maior que o comprimento do buffer.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O gravador de texto é descartado.

InvalidOperationException

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine(Char[], Int32, Int32).

Confira também

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

WriteLineAsync()

Origem:

TextWriter.cs

Grava de forma assíncrona um terminador de linha no fluxo de texto.

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

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

ObjectDisposedException

O gravador de texto é descartado.

InvalidOperationException

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine().

Confira também

• WriteLineAsync()

WriteLineAsync(StringBuilder, CancellationToken)

Origem:

TextWriter.cs

Grava de forma assíncrona a representação de texto de um construtor de cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.

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

Parâmetros

value

StringBuilder

A cadeia de caracteres, como um construtor de cadeia de caracteres, a ser gravada no fluxo de texto.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine(StringBuilder).

WriteLineAsync(Char)

Origem:

TextWriter.cs

Grava de forma assíncrona um caractere no fluxo de texto, seguido por um terminador de linha.

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

Parâmetros

value

Char

O caractere a ser gravado no fluxo de texto.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

ObjectDisposedException

O gravador de texto é descartado.

InvalidOperationException

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

A classe TextWriter é uma classe abstrata. Portanto, você não instanciá-lo em seu código. Para obter um exemplo de como usar o WriteLineAsync método , consulte o StreamWriter.WriteLineAsync método .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteLine(Char).

Confira também

• WriteLineAsync(Char)
• WriteLineAsync(Char)