ZipFileExtensions.CreateEntryFromFileAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Aggiunge in modo asincrono un file dal file system all'archivio con il nome della voce specificato. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Aggiunge in modo asincrono un file dal file system all'archivio con il nome della voce specificato. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Aggiunge in modo asincrono un file dal file system all'archivio con il nome della voce specificato.
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)Parametri
- destination
- ZipArchive
Archivio ZIP a cui aggiungere il file.
- sourceFileName
- String
Percorso del file nel file system da cui copiare. Il percorso è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
- entryName
- String
Nome della voce da creare.
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Wrapper per la voce appena creata.
Eccezioni
sourceFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
entryName è una stringa di lunghezza zero.
sourceFileName o entryName è null.
In sourceFileNameil percorso specificato, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi di file devono essere inferiori a 260 caratteri.
L'oggetto specificato sourceFileName non è valido, ad esempio in un'unità non mappata.
Si è verificato un errore di I/O durante l'apertura del file specificato da sourceFileName.
sourceFileName è stata specificata una directory.
oppure
Il chiamante non dispone dell'autorizzazione richiesta.
Il file specificato in sourceFileName non è stato trovato.
sourceFileName è in un formato non valido o zipArchive non supporta la scrittura.
ZipArchive è già stato chiuso.
Un'operazione asincrona viene annullata.
Commenti
La nuova voce nell'archivio conterrà il contenuto del file.
L'ora dell'ultima scrittura della voce di archiviazione viene impostata sull'ora dell'ultima scrittura del file nel file system.
Se esiste già una voce con il nome specificato nell'archivio, verrà creata una seconda voce con un nome identico.
Se il file di origine specificato ha un'ora dell'ultima modifica non valida, verrà utilizzato il primo valore datetime rappresentabile nel formato zip timestamp (mezzanotte 1 gennaio 1980). Se esiste già una voce con il nome specificato nell'archivio, verrà creata una seconda voce con un nome identico. Poiché non viene specificato alcun CompressionLevel valore, verrà utilizzato il valore predefinito fornito dall'implementazione dell'algoritmo di compressione sottostante. Non ZipArchive impone il proprio valore predefinito.
Attualmente, l'algoritmo di compressione sottostante viene fornito dalla DeflateStream classe .
Si applica a
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Aggiunge in modo asincrono un file dal file system all'archivio con il nome della voce specificato.
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)Parametri
- destination
- ZipArchive
Archivio ZIP a cui aggiungere il file.
- sourceFileName
- String
Percorso del file nel file system da cui copiare. Il percorso è autorizzato a specificare informazioni relative o assolute sul percorso. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente.
- entryName
- String
Nome della voce da creare.
- compressionLevel
- CompressionLevel
Livello della compressione (velocità/memoria rispetto al compromesso delle dimensioni compresse).
- cancellationToken
- CancellationToken
Token di annullamento da monitorare per le richieste di annullamento.
Valori restituiti
Wrapper per la voce appena creata.
Eccezioni
sourceFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.
oppure
entryName è una stringa di lunghezza zero.
sourceFileName o entryName è null.
In sourceFileNameil percorso specificato, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi di file devono essere inferiori a 260 caratteri.
L'oggetto specificato sourceFileName non è valido, ad esempio in un'unità non mappata.
Si è verificato un errore di I/O durante l'apertura del file specificato da sourceFileName.
sourceFileName è stata specificata una directory.
oppure
Il chiamante non dispone dell'autorizzazione richiesta.
Il file specificato in sourceFileName non è stato trovato.
sourceFileName è in un formato non valido o zipArchive non supporta la scrittura.
ZipArchive è già stato chiuso.
Un'operazione asincrona viene annullata.
Commenti
La nuova voce nell'archivio conterrà il contenuto del file.
L'ora dell'ultima scrittura della voce di archiviazione viene impostata sull'ora dell'ultima scrittura del file nel file system.
Se esiste già una voce con il nome specificato nell'archivio, verrà creata una seconda voce con un nome identico.
Se il file di origine specificato ha un'ora dell'ultima modifica non valida, verrà utilizzato il primo valore datetime rappresentabile nel formato zip timestamp (mezzanotte 1 gennaio 1980). Se esiste già una voce con il nome specificato nell'archivio, verrà creata una seconda voce con un nome identico.
