StreamWriter.WriteAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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
Origine:
StreamWriter.cs
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);
[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

Parametri

value
Char

Carattere da scrivere nel flusso.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Attributi
ComVisibleAttribute

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

Si applica a

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(System::String ^ value);
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);
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

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.

Attributi
ComVisibleAttribute

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

Si applica a

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

Si applica a

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(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

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.

Attributi
ComVisibleAttribute

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

Si applica a