File.WriteAllTextAsync 方法

定義

命名空間:

System.IO

組件:

netstandard.dll, System.Runtime.dll

多載

名稱	Description
WriteAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)	非同步建立新檔案，使用指定的編碼寫入指定的字串，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。
WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)	非同步建立新檔案，將指定的字串寫入檔案，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。
WriteAllTextAsync(String, String, CancellationToken)	非同步建立新檔案，將指定的字串寫入檔案，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。
WriteAllTextAsync(String, String, Encoding, CancellationToken)	非同步建立新檔案，使用指定的編碼寫入指定的字串，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。

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

來源:

File.cs

非同步建立新檔案，使用指定的編碼寫入指定的字串，然後關閉該檔案。

如果目標檔案已經存在，則會遭到截斷並覆寫。

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

參數

path

String

要寫入的檔案。

contents

ReadOnlyMemory<Char>

寫入檔案的字元。

encoding

Encoding

編碼要套用到字串上。

cancellationToken

CancellationToken

用來監控取消申請的代幣。 預設值為 None。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

WriteAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)

來源:

File.cs

非同步建立新檔案，將指定的字串寫入檔案，然後關閉該檔案。

如果目標檔案已經存在，則會遭到截斷並覆寫。

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

參數

path

String

要寫入的檔案。

contents

ReadOnlyMemory<Char>

寫入檔案的字元。

cancellationToken

CancellationToken

用來監控取消申請的代幣。 預設值為 None。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

WriteAllTextAsync(String, String, CancellationToken)

來源:

File.cs

非同步建立新檔案，將指定的字串寫入檔案，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。

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

參數

path

String

要寫入的檔案。

contents

String

寫入檔案的字串。

cancellationToken

CancellationToken

用來監控取消申請的代幣。 預設值為 None。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteAllText(String, String)拋出的例外。

WriteAllTextAsync(String, String, Encoding, CancellationToken)

來源:

File.cs

非同步建立新檔案，使用指定的編碼寫入指定的字串，然後關閉該檔案。 如果目標檔案已經存在，則會遭到截斷並覆寫。

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

參數

path

String

要寫入的檔案。

contents

String

寫入檔案的字串。

encoding

Encoding

編碼要套用到字串上。

cancellationToken

CancellationToken

用來監控取消申請的代幣。 預設值為 None。

傳回

Task

一個代表非同步寫入操作的任務。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteAllText(String, String, Encoding)拋出的例外。