StreamWriter.WriteLineAsync Método

Definição

Espaço de Nomes:: System.IO

Assemblagem:: netstandard.dll

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve dados de forma assíncrona no fluxo, seguido de um terminador de linha.

Sobrecargas

Name	Description
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	De forma assíncrona, escreve a representação de texto de uma região de memória de caracteres no fluxo, seguida de um terminador de linha.
WriteLineAsync()	Escreve assíncronamente um terminador de linha no fluxo.
WriteLineAsync(Char)	Escreve assíncronamente um carácter no fluxo, seguido de um terminador de linha.
WriteLineAsync(String)	Escreve assíncronamente uma cadeia no fluxo, seguida de um terminador de linha.
WriteLineAsync(Char[], Int32, Int32)	De forma assíncrona, escreve um subarray de caracteres no fluxo, seguido de um terminador de linha.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

De forma assíncrona, escreve a representação de texto de uma região de memória de caracteres no fluxo, seguida de 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 de memória de carácter para escrever no fluxo.

cancellationToken: CancellationToken

O token para monitorizar pedidos de cancelamento. O valor predefinido é None.

Devoluções

Task

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

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

O terminador de linha é definido pelo CoreNewLine campo.

Aplica-se a

WriteLineAsync()

Escreve assíncronamente um terminador de linha no fluxo.

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync();

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

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync () As Task

Devoluções

Task

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

Atributos: ComVisibleAttribute

Exceções

ObjectDisposedException

O escritor do stream está descartado.

InvalidOperationException

O escritor de stream está atualmente em uso por uma operação de escrita anterior.

Observações

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

Aplica-se a

WriteLineAsync(Char)

Escreve assíncronamente um carácter no fluxo, seguido de um terminador de linha.

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync(char value);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : char -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As Char) As Task

Parâmetros

value: Char

A personagem a escrever para o stream.

Devoluções

Task

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

Atributos: ComVisibleAttribute

Exceções

ObjectDisposedException

O escritor do stream está descartado.

InvalidOperationException

O escritor de stream está atualmente em uso por uma operação de escrita anterior.

Exemplos

O exemplo seguinte mostra como escrever um único carácter (a letra "a") numa linha num ficheiro de texto, seguido de outra linha que contenha um único carácter (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

Observações

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

Aplica-se a

WriteLineAsync(String)

Escreve assíncronamente uma cadeia no fluxo, seguida de um terminador de linha.

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync(string value);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : string -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As String) As Task

Parâmetros

value: String

A sequência para escrever. Se o valor for null, apenas um terminador de linha é escrito.

Devoluções

Task

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

Atributos: ComVisibleAttribute

Exceções

ObjectDisposedException

O escritor do stream está descartado.

InvalidOperationException

O escritor de stream está atualmente em uso por uma operação de escrita anterior.

Exemplos

O exemplo seguinte mostra como escrever duas linhas que consistem em valores de cadeia de caracteres num ficheiro 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

Observações

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

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteLine(String).

Aplica-se a

WriteLineAsync(Char[], Int32, Int32)

De forma assíncrona, escreve um subarray de caracteres no fluxo, seguido de um terminador de linha.

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

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

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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[]

O array de caracteres para escrever dados.

index: Int32

A posição do carácter no buffer onde começar a ler dados.

count: Int32

O número máximo de caracteres para escrever.

Devoluções

Task

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

Atributos: ComVisibleAttribute

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O index ponto positivo count é maior do que o comprimento do buffer.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O escritor do stream está descartado.

InvalidOperationException

O escritor de stream está atualmente em uso por uma operação de escrita anterior.

Exemplos

O exemplo seguinte mostra como escrever caracteres em duas linhas separadas num ficheiro de texto usando o WriteLineAsync(Char[], Int32, Int32) método. A primeira linha contém os primeiros 11 caracteres da sequência (as letras "Primeira linha" seguidas de um espaço). A segunda linha contém os caracteres restantes da sequência (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

Observações

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

Aplica-se a

Comentários

Esta página foi útil?