TarWriter.WriteEntryAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| WriteEntryAsync(TarEntry, CancellationToken) |
非同步地將指定的項目寫入壓縮串流。 |
| WriteEntryAsync(String, String, CancellationToken) |
非同步地將指定檔案寫入壓縮串流，作為 tar 條目。 |
WriteEntryAsync(TarEntry, CancellationToken)
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
非同步地將指定的項目寫入壓縮串流。
public System.Threading.Tasks.Task WriteEntryAsync(System.Formats.Tar.TarEntry entry, System.Threading.CancellationToken cancellationToken = default);member this.WriteEntryAsync : System.Formats.Tar.TarEntry * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As Task參數
- entry
- TarEntry
要寫焦油條目。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表非同步寫入操作的任務。
例外狀況
條目類型為 HardLink or SymbolicLink ，且 LinkName 是 null 或 empty。
檔案串流已被處理。
entry 是 null。
發生了 I/O 問題。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
在寫入檔案庫前，如果你已經將資料寫入該條目 DataStream，務必倒帶到想要的起始位置。
以下是每種格式所支援的輸入類型：
V7：
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteEntry(TarEntry)拋出的例外。
適用於
WriteEntryAsync(String, String, CancellationToken)
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
- 來源:
- TarWriter.cs
非同步地將指定檔案寫入壓縮串流，作為 tar 條目。
public System.Threading.Tasks.Task WriteEntryAsync(string fileName, string? entryName, System.Threading.CancellationToken cancellationToken = default);member this.WriteEntryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task參數
- fileName
- String
寫入檔案的路徑。
- entryName
- String
檔案名稱在檔案庫中應有的表示方式。 它應該包含可選的相對路徑和檔名。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
一個代表非同步寫入操作的任務。
例外狀況
檔案串流已被處理。
fileName 或 entryName 是空 null 的。
發生了 I/O 問題。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteEntry(String, String)拋出的例外。
