StreamWriter.WriteLineAsync Метод

Определение

Асинхронно записывает в поток данные, за которыми следует признак конца строки.Asynchronously writes data to the stream, followed by a line terminator.

Перегрузки

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Асинхронно записывает в поток текстовое представление области памяти символов, за которым следует знак конца строки.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

WriteLineAsync()

Асинхронно записывает признак конца строки в поток.Asynchronously writes a line terminator to the stream.

WriteLineAsync(Char)

Асинхронно записывает в поток символ, за которым следует признак конца строки.Asynchronously writes a character to the stream, followed by a line terminator.

WriteLineAsync(String)

Асинхронно записывает в поток строку, за которой следует признак конца строки.Asynchronously writes a string to the stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Асинхронно записывает в поток подмассив символов, за которым следует знак конца строки.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Асинхронно записывает в поток текстовое представление области памяти символов, за которым следует знак конца строки.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

Параметры

buffer
ReadOnlyMemory<Char>

Область памяти символов для записи в поток.The character memory region to write to the stream.

cancellationToken
CancellationToken

Маркер для отслеживания запросов на отмену.The token to monitor for cancellation requests. Значение по умолчанию — None.The default value is None.

Возвращаемое значение

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Комментарии

Признак конца строки определяется полем CoreNewLine.The line terminator is defined by the CoreNewLine field.

WriteLineAsync()

Асинхронно записывает признак конца строки в поток.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

Возвращаемое значение

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Атрибуты

Исключения

Удалено средство записи потока.The stream writer is disposed.

Средство записи потока в настоящее время используется предыдущей операцией записи.The stream writer is currently in use by a previous write operation.

Комментарии

Признак конца строки определяется свойством TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char)

Асинхронно записывает в поток символ, за которым следует признак конца строки.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

Параметры

value
Char

Символ, записываемый в поток.The character to write to the stream.

Возвращаемое значение

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Атрибуты

Исключения

Удалено средство записи потока.The stream writer is disposed.

Средство записи потока в настоящее время используется предыдущей операцией записи.The stream writer is currently in use by a previous write operation.

Примеры

В следующем примере показано, как записать один символ (букву "a") в строку в текстовом файле, а затем еще одну строку, содержащую один символ (буква "b"), с помощью метода 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

Комментарии

Признак конца строки определяется свойством TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(String)

Асинхронно записывает в поток строку, за которой следует признак конца строки.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

Параметры

value
String

Строка для записи.The string to write. Если значение равно null, записывается только знак конца строки.If the value is null, only a line terminator is written.

Возвращаемое значение

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Атрибуты

Исключения

Удалено средство записи потока.The stream writer is disposed.

Средство записи потока в настоящее время используется предыдущей операцией записи.The stream writer is currently in use by a previous write operation.

Примеры

В следующем примере показано, как записать две строки, состоящие из строковых значений, в текстовый файл с помощью метода 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

Комментарии

Признак конца строки определяется свойством TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char[], Int32, Int32)

Асинхронно записывает в поток подмассив символов, за которым следует знак конца строки.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

Параметры

buffer
Char[]

Массив символов, из которого записываются данные.The character array to write data from.

index
Int32

Положение символа в буфере, с которого начинается чтение данных.The character position in the buffer at which to start reading data.

count
Int32

Наибольшее количество символов для записи.The maximum number of characters to write.

Возвращаемое значение

Задача, представляющая асинхронную операцию записи.A task that represents the asynchronous write operation.

Атрибуты

Исключения

Свойство buffer имеет значение null.buffer is null.

Сумма значений параметров index и count превышает длину буфера.The index plus count is greater than the buffer length.

index или count является отрицательным значением.index or count is negative.

Удалено средство записи потока.The stream writer is disposed.

Средство записи потока в настоящее время используется предыдущей операцией записи.The stream writer is currently in use by a previous write operation.

Примеры

В следующем примере показано, как записать символы в две отдельные строки в текстовом файле с помощью метода 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. Первая строка содержит первые 11 символов из строки (буквы "первая строка", за которыми следует пробел).The first line contains the first 11 characters from the string (the letters "First line" followed by a space). Вторая строка содержит остальные символы из строки (буквы "и вторая строка").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

Комментарии

Признак конца строки определяется свойством TextWriter.NewLine.The line terminator is defined by the TextWriter.NewLine property.

Применяется к