StreamWriter.WriteAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

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

Scrive in modo asincrono un carattere nel flusso.

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

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

Parametri

value

Char

Carattere da scrivere nel flusso.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il writer di flusso viene eliminato.

InvalidOperationException

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

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

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

WriteAsync(String)

Origine:

StreamWriter.cs

Scrive in modo asincrono una stringa nel flusso.

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

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

Parametri

value

String

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

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il writer di flusso viene eliminato.

InvalidOperationException

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

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

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

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

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

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

OperationCanceledException

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

WriteAsync(Char[], Int32, Int32)

Origine:

StreamWriter.cs

Scrive in modo asincrono una sottomatrice di caratteri nel flusso.

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

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

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

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

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

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

Il writer di flusso viene eliminato.

InvalidOperationException

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

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

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