File.WriteAllTextAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken) |
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše. |
| WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken) |
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše. |
| WriteAllTextAsync(String, String, CancellationToken) |
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše. |
| WriteAllTextAsync(String, String, Encoding, CancellationToken) |
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše. |
WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře.
Pokud cílový soubor již existuje, zkrátí se a přepíše.
public static System.Threading.Tasks.Task WriteAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member WriteAllTextAsync : string * ReadOnlyMemory<char> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- path
- String
Soubor, do který se má zapisovat.
- contents
- ReadOnlyMemory<Char>
Znaky pro zápis do souboru.
- encoding
- Encoding
Kódování, které se má použít na řetězec.
- cancellationToken
- CancellationToken
Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.
Návraty
Úloha, která představuje asynchronní operaci zápisu.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Platí pro
WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře.
Pokud cílový soubor již existuje, zkrátí se a přepíše.
public static System.Threading.Tasks.Task WriteAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);static member WriteAllTextAsync : string * ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- path
- String
Soubor, do který se má zapisovat.
- contents
- ReadOnlyMemory<Char>
Znaky pro zápis do souboru.
- cancellationToken
- CancellationToken
Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.
Návraty
Úloha, která představuje asynchronní operaci zápisu.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Platí pro
WriteAllTextAsync(String, String, CancellationToken)
- Zdroj:
- File.cs
- Zdroj:
- File.cs
- Zdroj:
- File.cs
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);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 TaskParametry
- path
- String
Soubor, do který se má zapisovat.
- contents
- String
Řetězec pro zápis do souboru.
- cancellationToken
- CancellationToken
Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.
Návraty
Úloha, která představuje asynchronní operaci zápisu.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané WriteAllText(String, String).
Platí pro
WriteAllTextAsync(String, String, Encoding, CancellationToken)
- Zdroj:
- File.cs
- Zdroj:
- File.cs
- Zdroj:
- File.cs
Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
public static System.Threading.Tasks.Task WriteAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);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 TaskParametry
- path
- String
Soubor, do který se má zapisovat.
- contents
- String
Řetězec pro zápis do souboru.
- encoding
- Encoding
Kódování, které se má použít na řetězec.
- cancellationToken
- CancellationToken
Token pro monitorování žádostí o zrušení. Výchozí hodnota je None.
Návraty
Úloha, která představuje asynchronní operaci zápisu.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané WriteAllText(String, String, Encoding).
