ZipFileExtensions.ExtractToDirectoryAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrai assíncronamente todos os ficheiros do arquivo para um diretório no sistema de ficheiros. O diretório especificado já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrai todos os ficheiros do arquivo para um diretório no sistema de ficheiros. O diretório especificado pode já existir. |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extrai assíncronamente todos os ficheiros do arquivo para um diretório no sistema de ficheiros. O diretório especificado já pode existir.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- source
- ZipArchive
O arquivo zip para extrair ficheiros.
- destinationDirectoryName
- String
O caminho para o diretório no sistema de ficheiros.
- cancellationToken
- CancellationToken
O token de cancelamento para monitorizar pedidos de cancelamento.
Devoluções
Exceções
destinationDirectoryName é uma cadeia de comprimento zero, contém apenas espaços em branco, ou contém um ou mais caracteres inválidos conforme definido por InvalidPathChars.
destinationDirectoryName é null.
O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos ficheiros devem ser inferiores a 260 caracteres.
O caminho especificado é inválido (por exemplo, está num disco não mapeado).
O nome de uma entrada de arquivo é de comprimento zero, contém apenas espaços em branco ou contém um ou mais caracteres inválidos conforme definido por InvalidPathChars.
-ou-
Extrair uma entrada de arquivo teria resultado num ficheiro de destino que está fora destinationDirectoryName (por exemplo, se o nome da entrada contiver acessórios de diretório pai).
-ou-
Uma entrada de arquivo tem o mesmo nome que uma entrada já extraída do mesmo arquivo.
O interlocutor não tem a permissão necessária.
destinationDirectoryName está num formato inválido.
Uma entrada de arquivo não foi encontrada ou está corrompida.
-ou-
Uma entrada de arquivo foi comprimida usando um método de compressão que não é suportado.
Uma operação assíncrona é cancelada.
Observações
O diretório especificado não deve existir. O caminho pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual.
Este método cria todos os subdiretórios e o diretório especificado, se necessário.
Se houver um erro durante a extração do arquivo, este permanece parcialmente extraído.
Cada entrada é extraída de modo que o ficheiro extraído tenha o mesmo caminho relativo a destinationDirectoryName que a entrada tem até à raiz do arquivo. Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, será utilizada a primeira data-hora representável no formato de carimbo postal (meia-noite de 1 de janeiro de 1980).
Aplica-se a
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extrai todos os ficheiros do arquivo para um diretório no sistema de ficheiros. O diretório especificado pode já existir.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- source
- ZipArchive
O arquivo zip para extrair ficheiros.
- destinationDirectoryName
- String
O caminho para o diretório no sistema de ficheiros.
- overwriteFiles
- Boolean
true sobrescrever ficheiros; false caso contrário.
- cancellationToken
- CancellationToken
O token de cancelamento para monitorizar pedidos de cancelamento.
Devoluções
Exceções
destinationDirectoryName é uma cadeia de comprimento zero, contém apenas espaços em branco, ou contém um ou mais caracteres inválidos conforme definido por InvalidPathChars.
Este método criará todos os subdiretórios e o diretório especificado, se necessário.
Se houver um erro durante a extração do arquivo, este permanecerá parcialmente extraído.
Cada entrada é extraída de modo que o ficheiro extraído tenha o mesmo caminho relativo a destinationDirectoryName que a entrada tem até à raiz do arquivo. Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, será utilizada a primeira data-hora representável no formato de carimbo postal (meia-noite de 1 de janeiro de 1980).
destinationDirectoryName é null.
O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.
Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes dos ficheiros devem ser inferiores a 260 caracteres.
O caminho especificado é inválido (por exemplo, está num disco não mapeado).
O nome de uma entrada de arquivo é de comprimento zero, contém apenas espaços em branco ou contém um ou mais caracteres inválidos conforme definido por InvalidPathChars.
-ou-
Extrair uma entrada de arquivo teria resultado num ficheiro de destino que está fora destinationDirectoryName (por exemplo, se o nome da entrada contiver acessórios de diretório pai).
-ou-
Uma entrada de arquivo tem o mesmo nome que uma entrada já extraída do mesmo arquivo.
O interlocutor não tem a permissão necessária.
destinationDirectoryName está num formato inválido.
Nenhuma entrada de arquivo foi encontrada ou estava corrompida.
-ou-
Uma entrada de arquivo foi comprimida usando um método de compressão que não é suportado.
Observações
O diretório especificado não deve existir. O caminho pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual.
