File.AppendAllTextAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| AppendAllTextAsync(String, String, CancellationToken) |
Asynkront öppnar en fil eller skapar en fil om den inte redan finns, lägger till den angivna strängen i filen och stänger sedan filen. |
| AppendAllTextAsync(String, String, Encoding, CancellationToken) |
Asynkront öppnar en fil eller skapar filen om den inte redan finns, lägger till den angivna strängen i filen med den angivna kodningen och stänger sedan filen. |
AppendAllTextAsync(String, String, CancellationToken)
Asynkront öppnar en fil eller skapar en fil om den inte redan finns, lägger till den angivna strängen i filen och stänger sedan filen.
public static System.Threading.Tasks.Task AppendAllTextAsync(string path, string contents, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParametrar
- path
- String
Filen som den angivna strängen ska läggas till i.
- contents
- String
Strängen som ska läggas till i filen.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona tilläggsåtgärden.
Undantag
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AppendAllText(String, String).
Gäller för
AppendAllTextAsync(String, String, Encoding, CancellationToken)
Asynkront öppnar en fil eller skapar filen om den inte redan finns, lägger till den angivna strängen i filen med den angivna kodningen och stänger sedan filen.
public static System.Threading.Tasks.Task AppendAllTextAsync(string path, string contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParametrar
- path
- String
Filen som den angivna strängen ska läggas till i.
- contents
- String
Strängen som ska läggas till i filen.
- encoding
- Encoding
Teckenkodningen som ska användas.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona tilläggsåtgärden.
Undantag
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AppendAllText(String, String, Encoding).