StreamWriter.WriteLineAsync Metoda

Definicja

Asynchronicznie zapisuje dane do strumienia, po którym następuje terminator wiersza.Asynchronously writes data to the stream, followed by a line terminator.

Przeciążenia

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaku w strumieniu, po którym następuje terminator wiersza.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

WriteLineAsync()

Asynchronicznie zapisuje terminator wiersza w strumieniu.Asynchronously writes a line terminator to the stream.

WriteLineAsync(Char)

Asynchronicznie zapisuje znak w strumieniu, po którym następuje terminator wiersza.Asynchronously writes a character to the stream, followed by a line terminator.

WriteLineAsync(String)

Asynchronicznie zapisuje ciąg w strumieniu, po którym następuje terminator wiersza.Asynchronously writes a string to the stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje podtablicę znaków do strumienia, po którym następuje terminator wiersza.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaku w strumieniu, po którym następuje terminator wiersza.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Parametry

buffer
ReadOnlyMemory<Char>

Region pamięci znaku do zapisu w strumieniu.The character memory region to write to the stream.

cancellationToken
CancellationToken

Token do monitorowania żądań anulowania.The token to monitor for cancellation requests. Wartość domyślna to None.The default value is None.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Uwagi

Terminator wiersza jest definiowany przez pole CoreNewLine.The line terminator is defined by the CoreNewLine field.

WriteLineAsync()

Asynchronicznie zapisuje terminator wiersza w strumieniu.Asynchronously writes a line terminator to the stream.

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
Public Overrides Function WriteLineAsync () As Task

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Składnik zapisywania strumienia został usunięty.The stream writer is disposed.

Składnik zapisywania strumienia jest obecnie używany przez poprzednią operację zapisu.The stream writer is currently in use by a previous write operation.

Uwagi

Terminator wiersza jest zdefiniowany przez właściwość TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char)

Asynchronicznie zapisuje znak w strumieniu, po którym następuje terminator wiersza.Asynchronously writes a character to the stream, followed by a line terminator.

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
Public Overrides Function WriteLineAsync (value As Char) As Task

Parametry

value
Char

Znak do zapisu w strumieniu.The character to write to the stream.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Składnik zapisywania strumienia został usunięty.The stream writer is disposed.

Składnik zapisywania strumienia jest obecnie używany przez poprzednią operację zapisu.The stream writer is currently in use by a previous write operation.

Przykłady

Poniższy przykład pokazuje, jak napisać pojedynczy znak (literę "a") do wiersza w pliku tekstowym, a następnie inny wiersz zawierający pojedynczy znak (literę "b") przy użyciu metody WriteLineAsync(Char).The following example shows how to write a single character (the letter "a") to a line in a text file, followed by another line that contains a single character (the letter "b"), by using the WriteLineAsync(Char) method.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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

Uwagi

Terminator wiersza jest zdefiniowany przez właściwość TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(String)

Asynchronicznie zapisuje ciąg w strumieniu, po którym następuje terminator wiersza.Asynchronously writes a string to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);
[System.Runtime.InteropServices.ComVisible(false)]
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

Parametry

value
String

Ciąg do zapisu.The string to write. Jeśli wartość jest null, zostanie zapisany tylko terminator wiersza.If the value is null, only a line terminator is written.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Składnik zapisywania strumienia został usunięty.The stream writer is disposed.

Składnik zapisywania strumienia jest obecnie używany przez poprzednią operację zapisu.The stream writer is currently in use by a previous write operation.

Przykłady

Poniższy przykład pokazuje, jak napisać dwa wiersze, które składają się z wartości ciągu do pliku tekstowego za pomocą metody WriteLineAsync(String).The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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

Uwagi

Terminator wiersza jest zdefiniowany przez właściwość TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje podtablicę znaków do strumienia, po którym następuje terminator wiersza.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <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
Public Overrides Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

Parametry

buffer
Char[]

Tablica znaków, z której mają zostać zapisane dane.The character array to write data from.

index
Int32

Pozycja znaku w buforze, od którego ma zostać rozpoczęte odczytywanie danych.The character position in the buffer at which to start reading data.

count
Int32

Maksymalna liczba znaków do zapisania.The maximum number of characters to write.

Zwraca

Zadanie, które reprezentuje asynchroniczny zapis operacji.A task that represents the asynchronous write operation.

Atrybuty

Wyjątki

Parametr buffer ma wartość null.buffer is null.

index Plus count jest większa niż długość buforu.The index plus count is greater than the buffer length.

index lub count jest wartością ujemną.index or count is negative.

Składnik zapisywania strumienia został usunięty.The stream writer is disposed.

Składnik zapisywania strumienia jest obecnie używany przez poprzednią operację zapisu.The stream writer is currently in use by a previous write operation.

Przykłady

Poniższy przykład pokazuje, jak napisać znaki do dwóch oddzielnych wierszy w pliku tekstowym przy użyciu metody WriteLineAsync(Char[], Int32, Int32).The following example shows how to write characters to two separate lines in a text file by using the WriteLineAsync(Char[], Int32, Int32) method. Pierwszy wiersz zawiera pierwsze 11 znaków z ciągu (litery "pierwszy wiersz", po którym następuje spacja).The first line contains the first 11 characters from the string (the letters "First line" followed by a space). Drugi wiersz zawiera pozostałe znaki ciągu (litery "i drugi wiersz").The second line contains the remaining characters from the string (the letters "and second line").

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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

Uwagi

Terminator wiersza jest zdefiniowany przez właściwość TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

Dotyczy