File.WriteAllTextAsync Metódus

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Túlterhelések

Name	Description
WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)	Aszinkron módon létrehoz egy új fájlt, megírja a megadott sztringet a fájlba a megadott kódolással, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.
WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)	Aszinkron módon létrehoz egy új fájlt, írja a megadott sztringet a fájlba, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.
WriteAllTextAsync(String, String, CancellationToken)	Aszinkron módon létrehoz egy új fájlt, írja a megadott sztringet a fájlba, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Aszinkron módon létrehoz egy új fájlt, megírja a megadott sztringet a fájlba a megadott kódolással, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.

WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)

Forrás:

File.cs

Aszinkron módon létrehoz egy új fájlt, megírja a megadott sztringet a fájlba a megadott kódolással, majd bezárja a fájlt.

Ha a célfájl már létezik, csonkolja és felülírja.

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.Task

Public Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Paraméterek

path

String

A fájl, amelybe írni szeretne.

contents

ReadOnlyMemory<Char>

A fájlba írni kívánt karakterek.

encoding

Encoding

A sztringre alkalmazandó kódolás.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

Forrás:

File.cs

Aszinkron módon létrehoz egy új fájlt, írja a megadott sztringet a fájlba, majd bezárja a fájlt.

Ha a célfájl már létezik, csonkolja és felülírja.

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.Task

Public Shared Function WriteAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Paraméterek

path

String

A fájl, amelybe írni szeretne.

contents

ReadOnlyMemory<Char>

A fájlba írni kívánt karakterek.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

WriteAllTextAsync(String, String, CancellationToken)

Forrás:

File.cs

Aszinkron módon létrehoz egy új fájlt, írja a megadott sztringet a fájlba, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.

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

Paraméterek

path

String

A fájl, amelybe írni szeretne.

contents

String

A fájlba írni kívánt sztring.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által WriteAllText(String, String)kiadott kivételeket: .

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Forrás:

File.cs

Aszinkron módon létrehoz egy új fájlt, megírja a megadott sztringet a fájlba a megadott kódolással, majd bezárja a fájlt. Ha a célfájl már létezik, csonkolja és felülírja.

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

Paraméterek

path

String

A fájl, amelybe írni szeretne.

contents

String

A fájlba írni kívánt sztring.

encoding

Encoding

A sztringre alkalmazandó kódolás.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által WriteAllText(String, String, Encoding)kiadott kivételeket: .