StreamWriter.WriteAsync Metodo

Definizione

Scrive in modo asincrono i dati nel flusso.Asynchronously writes data to the stream.

Overload

WriteAsync(Char)

Scrive in modo asincrono un carattere nel flusso.Asynchronously writes a character to the stream.

WriteAsync(String)

Scrive in modo asincrono una stringa nel flusso.Asynchronously writes a string to the stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso.Asynchronously writes a character memory region to the stream.

WriteAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomatrice di caratteri nel flusso.Asynchronously writes a subarray of characters to the stream.

WriteAsync(Char)

Scrive in modo asincrono un carattere nel flusso.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

Parametri

value
Char

Carattere da scrivere nel flusso.The character to write to the stream.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

Attributi

Eccezioni

Il writer di flusso viene eliminato.The stream writer is disposed.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.The stream writer is currently in use by a previous write operation.

Esempi

Nell'esempio seguente viene illustrato come scrivere un singolo carattere (la lettera "a") in un file di testo utilizzando il metodo WriteAsync(Char).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)

Scrive in modo asincrono una stringa nel flusso.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

Parametri

value
String

Stringa da scrivere nel flusso.The string to write to the stream. Se value è null, non viene scritta alcuna voce.If value is null, nothing is written.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

Attributi

Eccezioni

Il writer di flusso viene eliminato.The stream writer is disposed.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.The stream writer is currently in use by a previous write operation.

Esempi

Nell'esempio seguente viene illustrato come scrivere una stringa in un file di testo utilizzando il metodo WriteAsync(String).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)

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso.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

Parametri

buffer
ReadOnlyMemory<Char>

Area di memoria dei caratteri da scrivere nel flusso.The character memory region to write to the stream.

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.The token to monitor for cancellation requests. Il valore predefinito è None.The default value is None.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

WriteAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomatrice di caratteri nel flusso.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

Parametri

buffer
Char[]

Matrice di caratteri che contiene i dati da scrivere.A character array that contains the data to write.

index
Int32

Posizione del carattere nel buffer da cui iniziare la lettura dei dati.The character position in the buffer at which to begin reading data.

count
Int32

Numero massimo di caratteri da scrivere.The maximum number of characters to write.

Restituisce

Attività che rappresenta l'operazione di scrittura asincrona.A task that represents the asynchronous write operation.

Attributi

Eccezioni

buffer è null.buffer is null.

La somma di index e count è maggiore della lunghezza del buffer.The index plus count is greater than the buffer length.

index o count è negativo.index or count is negative.

Il writer di flusso viene eliminato.The stream writer is disposed.

Il writer di flusso è attualmente utilizzato da un'operazione di scrittura precedente.The stream writer is currently in use by a previous write operation.

Esempi

Nell'esempio seguente viene illustrato come scrivere più caratteri in un file di testo utilizzando il metodo WriteAsync(Char[], Int32, Int32).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

Si applica a