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.

次の例では、WriteLineAsync(Char) メソッドを使用して、1つの文字 (文字 "a") をテキストファイル内の行に、その後に1つの文字を含む別の行 (文字 "b") を書き込む方法を示します。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) メソッドを使用して、文字列値で構成される2つの行をテキストファイルに書き込む方法を示します。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.

属性

例外

buffernull です。buffer is null.

indexcount を加算した値がバッファーの長さを超えています。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) メソッドを使用して、テキストファイル内の2つの異なる行に文字を書き込む方法を示します。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). 2行目には、文字列の残りの文字 (文字 "と2行目") が含まれています。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.

適用対象