StringWriter.WriteAsync Methode

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.dll

Assembly:: mscorlib.dll

Assembly:: System.IO.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt Daten asynchron in die Zeichenfolge.

Überlädt

Name	Beschreibung
WriteAsync(Char)	Schreibt asynchron ein Zeichen in die Zeichenfolge.
WriteAsync(String)	Schreibt eine Zeichenfolge asynchron in die aktuelle Zeichenfolge.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Schreibt asynchron einen Speicherbereich von Zeichen in die Zeichenfolge.
WriteAsync(Char[], Int32, Int32)	Schreibt ein Unterarray von Zeichen asynchron in die Zeichenfolge.

WriteAsync(Char)

Schreibt asynchron ein Zeichen in die Zeichenfolge.

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

Parameter

value: Char

Das Zeichen, das in die Zeichenfolge geschrieben werden soll.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ObjectDisposedException

Der Zeichenfolgenschreiber ist verworfen.

InvalidOperationException

Der Zeichenfolgenschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie Zeichen mithilfe der WriteAsync(Char) Methode geschrieben werden.

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
'

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(Char).

Gilt für:

WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in die aktuelle Zeichenfolge.

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

Parameter

value: String

Die zu schreibende Zeichenfolge. Wenn value ja null, wird nichts in den Textstream geschrieben.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ObjectDisposedException

Der Zeichenfolgenschreiber ist verworfen.

InvalidOperationException

Der Zeichenfolgenschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie sie eine Zeichenfolge mithilfe der WriteAsync(String) Methode schreiben.

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
'

Hinweise

Gilt für:

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt asynchron einen Speicherbereich von Zeichen in die Zeichenfolge.

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

Parameter

buffer: ReadOnlyMemory<Char>

Der Zeichenspeicherbereich, der in die Zeichenfolge geschrieben werden soll.

cancellationToken: CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Gilt für:

WriteAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen asynchron in die Zeichenfolge.

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

Parameter

buffer: Char[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index: Int32

Die Position im Puffer, an der mit dem Lesen von Daten begonnen werden soll.

count: Int32

Die maximale Anzahl von Zeichen, die geschrieben werden sollen.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

Das index Plus count ist größer als die Pufferlänge.

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Der Zeichenfolgenschreiber ist verworfen.

InvalidOperationException

Der Zeichenfolgenschreiber wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie Zeichen mithilfe der WriteAsync(Char[], Int32, Int32) Methode geschrieben werden.

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
'

Hinweise

Gilt für:

Feedback

War diese Seite hilfreich?