File.WriteAllTextAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| WriteAllTextAsync(String, String, CancellationToken) |
Er wordt asynchroon een nieuw bestand gemaakt, de opgegeven tekenreeks naar het bestand geschreven en vervolgens het bestand gesloten. Als het doelbestand al bestaat, wordt het afgekapt en overschreven. |
| WriteAllTextAsync(String, String, Encoding, CancellationToken) |
Asynchroon maakt een nieuw bestand, schrijft de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven. |
WriteAllTextAsync(String, String, CancellationToken)
Er wordt asynchroon een nieuw bestand gemaakt, de opgegeven tekenreeks naar het bestand geschreven en vervolgens het bestand gesloten. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
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.Task
Public Shared Function WriteAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameters
- path
- String
Het bestand waar naar moet worden geschreven.
- contents
- String
De tekenreeks die naar het bestand moet worden geschreven.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone schrijfbewerking vertegenwoordigt.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteAllText(String, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteAllTextAsync(String, String, Encoding, CancellationToken)
Asynchroon maakt een nieuw bestand, schrijft de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
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.Task
Public Shared Function WriteAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameters
- path
- String
Het bestand waar naar moet worden geschreven.
- contents
- String
De tekenreeks die naar het bestand moet worden geschreven.
- encoding
- Encoding
De codering die moet worden toegepast op de tekenreeks.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone schrijfbewerking vertegenwoordigt.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteAllText(String, String, Encoding)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.