StringWriter.WriteAsync 메서드

정의

네임스페이스:: System.IO

어셈블리:: mscorlib.dll, System.IO.dll

어셈블리:: mscorlib.dll

어셈블리:: System.IO.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

데이터를 문자열에 비동기적으로 씁니다.

오버로드

Name	Description
WriteAsync(Char)	문자열에 문자를 비동기적으로 씁니다.
WriteAsync(String)	문자열을 현재 문자열에 비동기적으로 씁니다.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	문자열에 문자의 메모리 영역을 비동기적으로 씁니다.
WriteAsync(Char[], Int32, Int32)	문자열에 문자의 하위 배열을 비동기적으로 씁니다.

WriteAsync(Char)

문자열에 문자를 비동기적으로 씁니다.

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

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

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

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

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

Public Overrides Function WriteAsync (value As Char) As Task

매개 변수

value: Char

문자열에 쓸 문자입니다.

반품

Task

비동기 쓰기 작업을 나타내는 작업입니다.

특성: ComVisibleAttribute

예외

ObjectDisposedException

문자열 작성기가 삭제됩니다.

InvalidOperationException

문자열 작성기는 현재 이전 쓰기 작업에서 사용 중입니다.

예제

다음 예제에서는 메서드를 사용하여 문자를 작성하는 방법을 보여 있습니다 WriteAsync(Char) .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
                foreach (char c in charsToAdd)
                {
                    await writer.WriteAsync(c);
                }
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
            For Each c As Char In charsToAdd
                Await writer.WriteAsync(c)
            Next
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Write(Char)throw된 예외를 참조하세요.

적용 대상

WriteAsync(String)

문자열을 현재 문자열에 비동기적으로 씁니다.

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

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

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

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

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

Public Overrides Function WriteAsync (value As String) As Task

매개 변수

value: String

쓸 문자열입니다. 이 value경우 null 텍스트 스트림에 아무 것도 기록되지 않습니다.

반품

Task

비동기 쓰기 작업을 나타내는 작업입니다.

특성: ComVisibleAttribute

예외

ObjectDisposedException

문자열 작성기가 삭제됩니다.

InvalidOperationException

문자열 작성기는 현재 이전 쓰기 작업에서 사용 중입니다.

예제

다음 예제에서는 메서드를 사용하여 WriteAsync(String) 문자열을 작성하는 방법을 보여줍니다.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                await writer.WriteAsync("and add characters through StringWriter");
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)
            Await writer.WriteAsync("and add characters through StringWriter")
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and add characters through StringWriter
'

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Write(String)throw된 예외를 참조하세요.

적용 대상

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

문자열에 문자의 메모리 영역을 비동기적으로 씁니다.

public override System.Threading.Tasks.Task WriteAsync(ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

buffer: ReadOnlyMemory<Char>

문자열에 쓸 문자 메모리 영역입니다.

cancellationToken: CancellationToken

취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반품

Task

비동기 쓰기 작업을 나타내는 작업입니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

적용 대상

WriteAsync(Char[], Int32, Int32)

문자열에 문자의 하위 배열을 비동기적으로 씁니다.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);

public override System.Threading.Tasks.Task WriteAsync(char[] buffer, int index, int count);

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

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

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

Public Overrides Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

매개 변수

buffer: Char[]

데이터를 쓸 문자 배열입니다.

index: Int32

데이터 읽기를 시작할 버퍼의 위치입니다.

count: Int32

쓸 최대 문자 수입니다.

반품

Task

비동기 쓰기 작업을 나타내는 작업입니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

buffer은 null입니다.

ArgumentException

index 더하기 count 는 버퍼 길이보다 큽합니다.

ArgumentOutOfRangeException

index 또는 count 음수입니다.

ObjectDisposedException

문자열 작성기가 삭제됩니다.

InvalidOperationException

문자열 작성기는 현재 이전 쓰기 작업에서 사용 중입니다.

예제

다음 예제에서는 메서드를 사용하여 문자를 작성하는 방법을 보여 있습니다 WriteAsync(Char[], Int32, Int32) .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));

                await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length);

                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))

            Await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length)

            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Write(Char[], Int32, Int32)throw된 예외를 참조하세요.

적용 대상

피드백

이 페이지가 도움이 되었나요?