File.WriteAllLinesAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Overload

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Crea un nuovo file in modo asincrono, scrive le righe specificate nel file e quindi lo chiude.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Crea un nuovo file in modo asincrono, vi scrive le righe specificate usando la codifica specificata e quindi lo chiude.

WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Origine:

File.cs

Crea un nuovo file in modo asincrono, scrive le righe specificate nel file e quindi lo chiude.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);

static member WriteAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

path

String

File in cui scrivere.

contents

IEnumerable<String>

Righe da scrivere nel file.

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.

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 WriteAllLines(String, IEnumerable<String>).

WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

Origine:

File.cs

Crea un nuovo file in modo asincrono, vi scrive le righe specificate usando la codifica specificata e quindi lo chiude.

public static System.Threading.Tasks.Task WriteAllLinesAsync (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member WriteAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function WriteAllLinesAsync (path As String, contents As IEnumerable(Of String), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

path

String

File in cui scrivere.

contents

IEnumerable<String>

Righe da scrivere nel file.

encoding

Encoding

Codifica dei caratteri da usare.

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.

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 WriteAllLines(String, IEnumerable<String>, Encoding).