StringWriter.WriteAsync Méthode

Définition

Écrit des données dans la chaîne de façon asynchrone.Writes data to the string asynchronously.

Surcharges

WriteAsync(Char)

Écrit un caractère dans la chaîne de façon asynchrone.Writes a character to the string asynchronously.

WriteAsync(String)

Écrit une chaîne dans la chaîne actuelle de façon asynchrone.Writes a string to the current string asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de façon asynchrone une zone de mémoire de caractères dans la chaîne.Asynchronously writes a memory region of characters to the string.

WriteAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone la représentation sous forme de texte d’un générateur de chaîne dans la chaîne.Asynchronously writes the text representation of a string builder to the string.

WriteAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans la chaîne de façon asynchrone.Writes a subarray of characters to the string asynchronously.

WriteAsync(Char)

Écrit un caractère dans la chaîne de façon asynchrone.Writes a character to the string asynchronously.

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

Paramètres

value
Char

Caractère à écrire dans la chaîne.The character to write to the string.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Attributs

Exceptions

Le writer de chaîne est supprimé.The string writer is disposed.

Le writer de chaîne est actuellement utilisé par une opération d’écriture précédente.The string writer is currently in use by a previous write operation.

Exemples

L’exemple suivant montre comment écrire des caractères à l’aide de la méthode WriteAsync(Char).The following example shows how to write characters by using the WriteAsync(Char) method.

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
'

WriteAsync(String)

Écrit une chaîne dans la chaîne actuelle de façon asynchrone.Writes a string to the current string asynchronously.

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

Paramètres

value
String

Chaîne à écrire.The string to write. Si value a la valeur null, rien n'est écrit dans le flux de texte.If value is null, nothing is written to the text stream.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Attributs

Exceptions

Le writer de chaîne est supprimé.The string writer is disposed.

Le writer de chaîne est actuellement utilisé par une opération d’écriture précédente.The string writer is currently in use by a previous write operation.

Exemples

L’exemple suivant montre comment écrire une chaîne à l’aide de la méthode WriteAsync(String).The following example shows how to write a string by using the WriteAsync(String) method.

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
'

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de façon asynchrone une zone de mémoire de caractères dans la chaîne.Asynchronously writes a memory region of characters to the string.

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

Paramètres

buffer
ReadOnlyMemory<Char>

Zone de mémoire de caractères à écrire dans la chaîne.The character memory region to write to the string.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests. La valeur par défaut est None.The default value is None.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

WriteAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone la représentation sous forme de texte d’un générateur de chaîne dans la chaîne.Asynchronously writes the text representation of a string builder to the string.

public override System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder value, System.Threading.CancellationToken cancellationToken = null);
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Paramètres

value
StringBuilder

Générateur de chaînes à écrire dans la chaîne.The string builder to write to the string.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.The token to monitor for cancellation requests. La valeur par défaut est None.The default value is None.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

WriteAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans la chaîne de façon asynchrone.Writes a subarray of characters to the string asynchronously.

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

Paramètres

buffer
Char[]

Tableau de caractères à partir duquel les données doivent être écrites.The character array to write data from.

index
Int32

Position dans la mémoire tampon où démarrer la lecture des données.The position in the buffer at which to start reading data.

count
Int32

Nombre maximal de caractères à écrire.The maximum number of characters to write.

Retours

Tâche qui représente l’opération d’écriture asynchrone.A task that represents the asynchronous write operation.

Attributs

Exceptions

buffer a la valeur null.buffer is null.

index plus count est supérieur à la longueur de la mémoire tampon.The index plus count is greater than the buffer length.

index ou count est un nombre négatif.index or count is negative.

Le writer de chaîne est supprimé.The string writer is disposed.

Le writer de chaîne est actuellement utilisé par une opération d’écriture précédente.The string writer is currently in use by a previous write operation.

Exemples

L’exemple suivant montre comment écrire des caractères à l’aide de la méthode WriteAsync(Char[], Int32, Int32).The following example shows how to write characters 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()
        {
            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
'

S’applique à