ZipFileExtensions.CreateEntryFromFileAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| Nama | Deskripsi |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Secara asinkron menambahkan file dari sistem file ke arsip dengan nama entri yang ditentukan. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Secara asinkron menambahkan file dari sistem file ke arsip dengan nama entri yang ditentukan. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Secara asinkron menambahkan file dari sistem file ke arsip dengan nama entri yang ditentukan.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parameter
- destination
- ZipArchive
Arsip zip untuk menambahkan file.
- sourceFileName
- String
Jalur ke file pada sistem file yang akan disalin. Jalur diizinkan untuk menentukan informasi jalur relatif atau absolut. Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini.
- entryName
- String
Nama entri yang akan dibuat.
- cancellationToken
- CancellationToken
Token pembatalan untuk memantau permintaan pembatalan.
Mengembalikan
Pembungkus untuk entri yang baru dibuat.
Pengecualian
sourceFileName adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid seperti yang didefinisikan oleh InvalidPathChars.
-atau-
entryName adalah string panjang nol.
sourceFileName atau entryName adalah null.
Dalam sourceFileName, jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem. Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
Yang ditentukan sourceFileName tidak valid, (misalnya, ada di drive yang tidak dipetakan).
Terjadi kesalahan I/O saat membuka file yang ditentukan oleh sourceFileName.
sourceFileName menentukan direktori.
-atau-
Pemanggil tidak memiliki izin yang diperlukan.
File yang ditentukan di sourceFileName tidak ditemukan.
sourceFileName dalam format yang tidak valid atau ZipArchive tidak mendukung penulisan.
ZipArchive sudah ditutup.
Operasi asinkron dibatalkan.
Keterangan
Entri baru dalam arsip akan berisi isi file.
Waktu tulis terakhir entri arsip diatur ke waktu tulis terakhir file pada sistem file.
Jika entri dengan nama yang ditentukan sudah ada di arsip, entri kedua akan dibuat yang memiliki nama yang identik.
Jika file sumber yang ditentukan memiliki waktu modifikasi terakhir yang tidak valid, tanggalwaktu pertama yang dapat diwakili dalam format tanda waktu Zip (tengah malam pada 1 Januari 1980) akan digunakan. Jika entri dengan nama yang ditentukan sudah ada di arsip, entri kedua akan dibuat yang memiliki nama yang identik. Karena tidak CompressionLevel ditentukan, default yang disediakan oleh implementasi algoritma kompresi yang mendasar akan digunakan; ZipArchive tidak akan memberlakukan defaultnya sendiri.
(Saat ini, algoritma kompresi yang mendasar disediakan oleh DeflateStream kelas .)
Berlaku untuk
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Secara asinkron menambahkan file dari sistem file ke arsip dengan nama entri yang ditentukan.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parameter
- destination
- ZipArchive
Arsip zip untuk menambahkan file.
- sourceFileName
- String
Jalur ke file pada sistem file yang akan disalin. Jalur diizinkan untuk menentukan informasi jalur relatif atau absolut. Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini.
- entryName
- String
Nama entri yang akan dibuat.
- compressionLevel
- CompressionLevel
Tingkat kompresi (kecepatan/memori vs. trade-off ukuran terkompresi).
- cancellationToken
- CancellationToken
Token pembatalan untuk memantau permintaan pembatalan.
Mengembalikan
Pembungkus untuk entri yang baru dibuat.
Pengecualian
sourceFileName adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid seperti yang didefinisikan oleh InvalidPathChars.
-atau-
entryName adalah string panjang nol.
sourceFileName atau entryName adalah null.
Dalam sourceFileName, jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem. Misalnya, pada platform berbasis Windows, jalur harus kurang dari 248 karakter, dan nama file harus kurang dari 260 karakter.
Yang ditentukan sourceFileName tidak valid, (misalnya, ada di drive yang tidak dipetakan).
Terjadi kesalahan I/O saat membuka file yang ditentukan oleh sourceFileName.
sourceFileName menentukan direktori.
-atau-
Pemanggil tidak memiliki izin yang diperlukan.
File yang ditentukan di sourceFileName tidak ditemukan.
sourceFileName dalam format yang tidak valid atau ZipArchive tidak mendukung penulisan.
ZipArchive sudah ditutup.
Operasi asinkron dibatalkan.
Keterangan
Entri baru dalam arsip akan berisi isi file.
Waktu tulis terakhir entri arsip diatur ke waktu tulis terakhir file pada sistem file.
Jika entri dengan nama yang ditentukan sudah ada di arsip, entri kedua akan dibuat yang memiliki nama yang identik.
Jika file sumber yang ditentukan memiliki waktu modifikasi terakhir yang tidak valid, tanggalwaktu pertama yang dapat diwakili dalam format tanda waktu Zip (tengah malam pada 1 Januari 1980) akan digunakan. Jika entri dengan nama yang ditentukan sudah ada di arsip, entri kedua akan dibuat yang memiliki nama yang identik.
