TextWriter.WriteLineAsync Método

Definição

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

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

Exceções

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

Comentários

O terminador de linha é definido pelo CoreNewLine campo .

Aplica-se a

WriteLineAsync(String)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
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);
public virtual System.Threading.Tasks.Task WriteLineAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

Atributos

Exceções

O gravador de texto é descartado.

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

Aplica-se a

WriteLineAsync(Char[])

Origem:
TextWriter.cs
Origem:
TextWriter.cs
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);
public System.Threading.Tasks.Task WriteLineAsync (char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteLineAsync (char[] buffer);
member this.WriteLineAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

Atributos

Exceções

O gravador de texto é descartado.

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

Aplica-se a

WriteLineAsync(Char[], Int32, Int32)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
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);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

Atributos

Exceções

buffer é null.

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

index ou count é negativo.

O gravador de texto é descartado.

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

Aplica-se a

WriteLineAsync()

Origem:
TextWriter.cs
Origem:
TextWriter.cs
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 ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task WriteLineAsync ();
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteLineAsync : unit -> System.Threading.Tasks.Task
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function WriteLineAsync () As Task

Retornos

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

Atributos

Exceções

O gravador de texto é descartado.

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

Aplica-se a

WriteLineAsync(StringBuilder, CancellationToken)

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

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

Exceções

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

Aplica-se a

WriteLineAsync(Char)

Origem:
TextWriter.cs
Origem:
TextWriter.cs
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);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

Atributos

Exceções

O gravador de texto é descartado.

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

Aplica-se a