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.
Extrai todos os ficheiros do arquivo para um diretório no sistema de ficheiros. O diretório especificado pode já existir.
Sobrecargas
| Nome | Descrição |
|---|---|
| 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 já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
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. O diretório já pode existir. Os diretórios em falta são criados conforme necessário ao extrair entradas.
- 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
Warning
Este método não deve ser usado para extrair arquivos não confiáveis. Não aplica quaisquer limites de tamanho, de número de entradas ou outras políticas necessárias para a extração segura de arquivos não confiáveis. Para mais informações sobre como extrair arquivos de fontes não confiáveis em segurança, consulte Melhores práticas para utilização de arquivos zip e tar.
O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.
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.
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 já pode 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. O diretório já pode existir. Os diretórios em falta são criados conforme necessário ao extrair entradas.
- 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 cria diretórios em falta conforme necessário ao extrair entradas.
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
Warning
Este método não deve ser usado para extrair arquivos não confiáveis. Não aplica quaisquer limites de tamanho, de número de entradas ou outras políticas necessárias para a extração segura de arquivos não confiáveis. Para mais informações sobre como extrair arquivos de fontes não confiáveis em segurança, consulte Melhores práticas para utilização de arquivos zip e tar.
O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.
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.
Aplica-se a
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- source
- ZipArchive
- destinationDirectoryName
- String
O caminho para o diretório onde colocar os ficheiros extraídos. O diretório já pode existir. Os diretórios em falta são criados conforme necessário ao extrair entradas.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Devoluções
Observações
Warning
Este método não deve ser usado para extrair arquivos não confiáveis. Não aplica quaisquer limites de tamanho, de número de entradas ou outras políticas necessárias para a extração segura de arquivos não confiáveis. Para mais informações sobre como extrair arquivos de fontes não confiáveis em segurança, consulte Melhores práticas para utilização de arquivos zip e tar.
O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.
Cada ficheiro extraído tem o mesmo caminho relativo a destinationDirectoryName que a sua entrada de origem tem até à raiz do arquivo.
O destinationDirectoryName parâmetro aceita caminhos relativos e absolutos. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.
Se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído.
Definir OverwriteFiles para true sobrescrever ficheiros existentes. O padrão é false, o que faz com que a extração lance um IOException se já existe um ficheiro a extrair.
Use Password para fornecer a palavra-passe para entradas encriptadas.
EntryNameEncoding não é usado por esta sobrecarga. Os nomes das entradas e comentários são decodificados usando a codificação especificada quando o source arquivo é aberto.
Os links simbólicos no arquivo não são recriados como links simbólicos. Se destinationDirectoryName ou qualquer um dos seus diretórios-pai for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.
Exceções que ocorrem durante a extração assíncrona são armazenadas na tarefa devolvida e lançadas quando a tarefa é aguardada.
