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

매개 변수

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.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.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();
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

반환

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

매개 변수

value
Char

스트림에 쓸 문자입니다.The character to write to the stream.

반환

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.

예제

다음 예제에서는 메서드를 사용 하 여 단일 문자 (문자 "a")를 텍스트 파일의 줄에 쓴 다음 단일 문자 (문자 "b")를 포함 하는 다른 줄에 문자 "a"를 쓰는 방법을 보여 줍니다 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);
public override System.Threading.Tasks.Task WriteLineAsync (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

매개 변수

value
String

쓸 문자열입니다.The string to write. 값이 null이면 줄 종결자만 씁니다.If the value is null, only a line terminator is written.

반환

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.

예제

다음 예제에서는 메서드를 사용 하 여 문자열 값으로 구성 된 두 줄을 텍스트 파일로 쓰는 방법을 보여 줍니다 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);
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

매개 변수

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.

반환

Task

비동기 쓰기 작업을 나타내는 작업입니다.A task that represents the asynchronous write operation.

특성

예외

buffer이(가) null인 경우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) .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 자 (문자 "First line")와 공백이 있습니다.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.

적용 대상