TextWriter.WriteLineAsync Método

Definição

Grava dados no fluxo de texto de forma assíncrona, seguidos por um terminador de linha.Asynchronously writes data to the text stream, followed by a line terminator.

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.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String)

Grava de forma assíncrona uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(Char[])

Grava de forma assíncrona uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

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.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLineAsync()

Grava de forma assíncrona um terminador de linha no fluxo de texto.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char)

Grava de forma assíncrona um caractere no fluxo de texto, seguido por um terminador de linha.Asynchronously writes a character to the text stream, followed by a line terminator.

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.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

Comentários

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteLineAsync método, consulte o StreamWriter.WriteLineAsync método.For an example of using the WriteLineAsync method, see the StreamWriter.WriteLineAsync method.

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.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

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.The character memory region to write to the text stream.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Aplica-se a

WriteLineAsync(String)

Grava de forma assíncrona uma cadeia de caracteres no fluxo de texto, seguida por um terminador de linha.Asynchronously writes a string to the text stream, followed by a line terminator.

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.The string to write. Se o valor for null, somente um terminador de linha será gravado.If the value is null, only a line terminator is written.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteLineAsync método, consulte o StreamWriter.WriteLineAsync método.For an example of using the WriteLineAsync method, see the StreamWriter.WriteLineAsync method.

Confira também

Aplica-se a

WriteLineAsync(Char[])

Grava de forma assíncrona uma matriz de caracteres no fluxo de texto, seguida por um terminador de linha no fluxo.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

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.The character array to write to the text stream. Se a matriz de caracteres for null, somente o terminador de linha será gravado.If the character array is null, only the line terminator is written.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a

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.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

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.The string, as a string builder, to write to the text stream.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Aplica-se a

WriteLineAsync()

Grava de forma assíncrona um terminador de linha no fluxo de texto.Asynchronously writes a line terminator to the text stream.

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

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a

WriteLineAsync(Char)

Grava de forma assíncrona um caractere no fluxo de texto, seguido por um terminador de linha.Asynchronously writes a character to the text stream, followed by a line terminator.

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.The character to write to the text stream.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteLineAsync método, consulte o StreamWriter.WriteLineAsync método.For an example of using the WriteLineAsync method, see the StreamWriter.WriteLineAsync method.

Confira também

Aplica-se a

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.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

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.The character array to write data from.

index
Int32

A posição do caractere no buffer em que iniciar a recuperação de dados.The character position in the buffer at which to start retrieving data.

count
Int32

O número de caracteres a serem gravados.The number of characters to write.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

buffer é null.buffer is null.

O index mais count é maior que o comprimento do buffer.The index plus count is greater than the buffer length.

index ou count é negativo.index or count is negative.

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

O terminador de linha é definido pelo CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Confira também

Aplica-se a