File.WriteAllTextAsync 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 |
|---|---|
| WriteAllTextAsync(String, String, CancellationToken) |
Asynkront skapar en ny fil, skriver den angivna strängen till filen och stänger sedan filen. Om målfilen redan finns trunkeras den och skrivs över. |
| WriteAllTextAsync(String, String, Encoding, CancellationToken) |
Skapar asynkront en ny fil, skriver den angivna strängen till filen med den angivna kodningen och stänger sedan filen. Om målfilen redan finns trunkeras den och skrivs över. |
WriteAllTextAsync(String, String, CancellationToken)
Asynkront skapar en ny fil, skriver den angivna strängen till filen och stänger sedan filen. Om målfilen redan finns trunkeras den och skrivs över.
public static System.Threading.Tasks.Task WriteAllTextAsync(string path, string contents, System.Threading.CancellationToken cancellationToken = default);static member WriteAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParametrar
- path
- String
Filen som ska skrivas till.
- contents
- String
Strängen som ska skrivas till filen.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona skrivå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 WriteAllText(String, String).
Gäller för
WriteAllTextAsync(String, String, Encoding, CancellationToken)
Skapar asynkront en ny fil, skriver den angivna strängen till filen med den angivna kodningen och stänger sedan filen. Om målfilen redan finns trunkeras den och skrivs över.
public static System.Threading.Tasks.Task WriteAllTextAsync(string path, string contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member WriteAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParametrar
- path
- String
Filen som ska skrivas till.
- contents
- String
Strängen som ska skrivas till filen.
- encoding
- Encoding
Kodningen som ska tillämpas på strängen.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.
Returer
En uppgift som representerar den asynkrona skrivå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 WriteAllText(String, String, Encoding).