StreamWriter.WriteLineAsync Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Grava dados no fluxo 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, seguida por um terminador de linha.
WriteLineAsync()	Grava de forma assíncrona um terminador de linha no fluxo.
WriteLineAsync(Char)	Grava de forma assíncrona um caractere no fluxo, seguido por um terminador de linha.
WriteLineAsync(String)	Grava de forma assíncrona uma cadeia de caracteres no fluxo, seguida por um terminador de linha.
WriteLineAsync(Char[], Int32, Int32)	Grava de forma assíncrona uma submatriz de caracteres no fluxo, seguida por um terminador de linha no fluxo.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Origem:

StreamWriter.cs

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

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

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

Public Overrides 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.

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

Origem:

StreamWriter.cs

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

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

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

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

Public Overrides Function WriteLineAsync () As Task

Retornos

Task

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

Exceções

ObjectDisposedException

O gravador de fluxo é descartado.

InvalidOperationException

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

Comentários

O terminador de linha é definido pela TextWriter.NewLine propriedade .

WriteLineAsync(Char)

Origem:

StreamWriter.cs

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

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

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

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

Public Overrides Function WriteLineAsync (value As Char) As Task

Parâmetros

value

Char

O caractere a ser gravado no fluxo.

Retornos

Task

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

Exceções

ObjectDisposedException

O gravador de fluxo é descartado.

InvalidOperationException

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

Exemplos

O exemplo a seguir mostra como gravar um único caractere (a letra "a") em uma linha em um arquivo de texto, seguido por outra linha que contém um único caractere (a letra "b"), usando o WriteLineAsync(Char) método .

using System.IO;

namespace ConsoleApplication
{
    class Program3
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync('a');
                await writer.WriteLineAsync('b');
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim firstChar As Char = "a"
        Dim secondChar As Char = "b"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(firstChar)
            Await writer.WriteLineAsync(secondChar)
        End Using
    End Sub
End Module

Comentários

O terminador de linha é definido pela TextWriter.NewLine propriedade .

WriteLineAsync(String)

Origem:

StreamWriter.cs

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

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

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

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

Public Overrides 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 fluxo é descartado.

InvalidOperationException

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

Exemplos

O exemplo a seguir mostra como gravar duas linhas que consistem em valores de cadeia de caracteres em um arquivo de texto usando o WriteLineAsync(String) método .

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Comentários

O terminador de linha é definido pela TextWriter.NewLine propriedade .

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona 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).

WriteLineAsync(Char[], Int32, Int32)

Origem:

StreamWriter.cs

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

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

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

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

Public Overrides 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 no qual iniciar a leitura de dados.

count

Int32

O número máximo 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 fluxo é descartado.

InvalidOperationException

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

Exemplos

O exemplo a seguir mostra como gravar caracteres em duas linhas separadas em um arquivo de texto usando o WriteLineAsync(Char[], Int32, Int32) método . A primeira linha contém os primeiros 11 caracteres da cadeia de caracteres (as letras "Primeira linha" seguidas por um espaço). A segunda linha contém os caracteres restantes da cadeia de caracteres (as letras "e a segunda linha").

using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program6
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("First line and second line"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync(charsToAdd, 0, 11);
                await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim ue As UnicodeEncoding = New UnicodeEncoding()
        Dim charsToAdd() = ue.GetChars(ue.GetBytes("First line and second line"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(charsToAdd, 0, 11)
            Await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11)
        End Using
    End Sub
End Module

Comentários

O terminador de linha é definido pela TextWriter.NewLine propriedade .