StreamWriter.WriteAsync Metodo

Definizione

Scrive in modo asincrono i dati nel flusso.

Overload

WriteAsync(Char)

Scrive in modo asincrono un carattere nel flusso.

WriteAsync(String)

Scrive in modo asincrono una stringa nel flusso.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso.

WriteAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomatrice di caratteri nel flusso.

WriteAsync(Char)

Origine:
StreamWriter.cs
Origine:
StreamWriter.cs
Origine:
StreamWriter.cs

Scrive in modo asincrono un carattere nel flusso.

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

Parametri

value
Char

Carattere da scrivere nel flusso.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Attributi

Eccezioni

Il writer di flusso viene eliminato.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.

Esempio

Nell'esempio seguente viene illustrato come scrivere un singolo carattere (la lettera "a") in un file di testo usando il WriteAsync(Char) metodo .

using System.IO;

namespace ConsoleApplication
{
    class Program1
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync('a');
            }
        }
    }
}

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Write(Char).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteAsync(String)

Origine:
StreamWriter.cs
Origine:
StreamWriter.cs
Origine:
StreamWriter.cs

Scrive in modo asincrono una stringa nel flusso.

public override System.Threading.Tasks.Task WriteAsync (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);

Parametri

value
String

Stringa da scrivere nel flusso. Se value è null, non viene scritta alcuna voce.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Attributi

Eccezioni

Il writer di flusso viene eliminato.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.

Esempio

Nell'esempio seguente viene illustrato come scrivere una stringa in un file di testo usando il WriteAsync(String) metodo .

using System.IO;

namespace ConsoleApplication
{
    class Program2
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync("Example text as string");
            }
        }
    }
}

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Write(String).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Origine:
StreamWriter.cs
Origine:
StreamWriter.cs
Origine:
StreamWriter.cs

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso.

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

Parametri

buffer
ReadOnlyMemory<Char>

Area di memoria dei caratteri da scrivere nel flusso.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

WriteAsync(Char[], Int32, Int32)

Origine:
StreamWriter.cs
Origine:
StreamWriter.cs
Origine:
StreamWriter.cs

Scrive in modo asincrono una sottomatrice di caratteri nel flusso.

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

Parametri

buffer
Char[]

Matrice di caratteri che contiene i dati da scrivere.

index
Int32

Posizione del carattere nel buffer da cui iniziare la lettura dei dati.

count
Int32

Numero massimo di caratteri da scrivere.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.

Attributi

Eccezioni

buffer è null.

La somma di index e count è maggiore della lunghezza del buffer.

index o count è negativo.

Il writer di flusso viene eliminato.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.

Esempio

Nell'esempio seguente viene illustrato come scrivere più caratteri in un file di testo usando il WriteAsync(Char[], Int32, Int32) metodo .

using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program5
    {
        static void Main()
        {
            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);
            }
        }
    }
}

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Write(Char[], Int32, Int32).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0