StreamWriter.WriteAsync StreamWriter.WriteAsync StreamWriter.WriteAsync StreamWriter.WriteAsync Method

Definition

Schreibt Daten asynchron in den Datenstrom.Asynchronously writes data to the stream.

Überlädt

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Schreibt ein Zeichen asynchron in den Datenstrom.Asynchronously writes a character to the stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Datenstrom.Asynchronously writes a string to the stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt einen Zeichenspeicherbereich asynchron in den Datenstrom.Asynchronously writes a character memory region to the stream.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Datenstrom.Asynchronously writes a subarray of characters to the stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Schreibt ein Zeichen asynchron in den Datenstrom.Asynchronously writes a character to the stream.

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
Public Overrides Function WriteAsync (value As Char) As Task

Parameter

value
Char Char Char Char

Das in den Stream zu schreibende Zeichen.The character to write to the stream.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein einzelnes Zeichen (der Buchstabe "a") mithilfe der WriteAsync(Char) -Methode in eine Textdatei geschrieben wird.The following example shows how to write a single character (the letter "a") to a text file by using the WriteAsync(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.WriteAsync('a');
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim oneLetter As Char = "a"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(oneLetter)
        End Using
    End Sub
End Module

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Schreibt eine Zeichenfolge asynchron in den Datenstrom.Asynchronously writes a string to the stream.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteAsync (string value);
override this.WriteAsync : string -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (value As String) As Task

Parameter

value
String String String String

Die Zeichenfolge, die in den Stream geschrieben werden soll.The string to write to the stream. Wenn value den Wert null ist, wird nichts geschrieben.If value is null, nothing is written.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine Zeichenfolge mithilfe der WriteAsync(String) -Methode in eine Textdatei geschrieben wird.The following example shows how to write a string to a text file by using the WriteAsync(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.WriteAsync("Example text as string");
            }
        }
    }
}
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.WriteAsync("Example text as string")
        End Using
    End Sub
End Module

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt einen Zeichenspeicherbereich asynchron in den Datenstrom.Asynchronously writes a character memory region to the stream.

public override System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Parameter

buffer
ReadOnlyMemory<Char>

Der Zeichenspeicherbereich, der in den Datenstrom geschrieben werden soll.The character memory region to write to the stream.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.The token to monitor for cancellation requests. Der Standardwert ist Nonesein.The default value is None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen asynchron in den Datenstrom.Asynchronously writes a subarray of characters to the stream.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <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
Public Overrides Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

Parameter

buffer
Char[]

Ein Zeichenarray, das die zu schreibenden Daten enthält.A character array that contains the data to write.

index
Int32 Int32 Int32 Int32

Die Zeichenposition im Puffer, an der mit dem Lesen von Daten begonnen werden soll.The character position in the buffer at which to begin reading data.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu schreibenden Zeichen.The maximum number of characters to write.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

index plus count ist größer als die Pufferlänge.The index plus count is greater than the buffer length.

index oder count ist ein negativer Wert.index or count is negative.

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie mithilfe der WriteAsync(Char[], Int32, Int32) -Methode mehrere Zeichen in eine Textdatei geschrieben werden.The following example shows how to write multiple characters to a text file by using the WriteAsync(Char[], Int32, Int32) method.

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("Example string"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length);
            }
        }
    }
}
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("Example string"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length)
        End Using
    End Sub
End Module

Gilt für: