ZipFileExtensions.ExtractToDirectoryAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Extrai todos os arquivos no arquivo morto para um diretório no sistema de arquivos. O diretório especificado já pode existir.
Sobrecargas
| Nome | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrai de forma assíncrona todos os arquivos no arquivo morto para um diretório no sistema de arquivos. O diretório especificado já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrai todos os arquivos no arquivo morto para um diretório no sistema de arquivos. O diretório especificado já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extrai de forma assíncrona todos os arquivos no arquivo morto para um diretório no sistema de arquivos. 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 do qual extrair arquivos.
- destinationDirectoryName
- String
O caminho para o diretório no sistema de arquivos. O diretório já pode existir. Os diretórios ausentes são criados conforme necessário ao extrair entradas.
- cancellationToken
- CancellationToken
O token de cancelamento a ser monitorado para solicitações de cancelamento.
Retornos
Exceções
destinationDirectoryName é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos, conforme definido por InvalidPathChars.
destinationDirectoryName é null.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ter menos de 248 caracteres e os nomes de arquivo devem ter menos de 260 caracteres.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
O nome de uma entrada de arquivo morto tem comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos, conforme definido por InvalidPathChars.
- ou -
A extração de uma entrada de arquivo morto teria resultado em um arquivo de destino que está fora destinationDirectoryName (por exemplo, se o nome da entrada contiver acessadores de diretório pai).
- ou -
Uma entrada de arquivo morto tem o mesmo nome de uma entrada já extraída do mesmo arquivo.
O chamador não tem a permissão necessária.
destinationDirectoryName está em um formato inválido.
Uma entrada de arquivo morto não foi encontrada ou está corrompida.
- ou -
Uma entrada de arquivo morto foi compactada usando um método de compactação que não tem suporte.
Uma operação assíncrona é cancelada.
Comentários
Warning
Esse método não deve ser usado para extrair arquivos não confiáveis. Ele não impõe limites de tamanho, limites de contagem de entradas ou outras políticas necessárias para extração segura de arquivos não confiáveis. Para obter mais informações sobre como extrair arquivos com segurança de fontes não confiáveis, consulte As práticas recomendadas para usar arquivos zip e tar.
O diretório especificado por destinationDirectoryName ele já pode existir. Esse método cria o diretório de destino, seus diretórios pai ausentes e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, esse método não criará o diretório de destino.
O caminho tem permissão para especificar informações de caminho relativas ou absolutas. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual.
Se houver um erro ao extrair o arquivo morto, o arquivo permanecerá parcialmente extraído.
Cada entrada é extraída de modo que o arquivo extraído tenha o mesmo caminho relativo para destinationDirectoryName o qual a entrada tem para a raiz do arquivo morto. Se um arquivo a ser arquivado tiver uma hora de última modificação inválida, o primeiro datetime representável no formato de carimbo de data/hora zip (meia-noite de 1º de janeiro de 1980) será usado.
Aplica-se a
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extrai todos os arquivos no arquivo morto para um diretório no sistema de arquivos. 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 do qual extrair arquivos.
- destinationDirectoryName
- String
O caminho para o diretório no sistema de arquivos. O diretório já pode existir. Os diretórios ausentes são criados conforme necessário ao extrair entradas.
- overwriteFiles
- Boolean
true para substituir arquivos; false Caso contrário.
- cancellationToken
- CancellationToken
O token de cancelamento a ser monitorado para solicitações de cancelamento.
Retornos
Exceções
destinationDirectoryName é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos, conforme definido por InvalidPathChars.
Esse método cria diretórios ausentes conforme necessário ao extrair entradas.
Se houver um erro ao extrair o arquivo morto, o arquivo permanecerá parcialmente extraído.
Cada entrada é extraída de modo que o arquivo extraído tenha o mesmo caminho relativo para destinationDirectoryName o qual a entrada tem para a raiz do arquivo morto. Se um arquivo a ser arquivado tiver uma hora de última modificação inválida, o primeiro datetime representável no formato de carimbo de data/hora zip (meia-noite de 1º de janeiro de 1980) será usado.
destinationDirectoryName é null.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
Por exemplo, em plataformas baseadas no Windows, os caminhos devem ter menos de 248 caracteres e os nomes de arquivo devem ter menos de 260 caracteres.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
O nome de uma entrada de arquivo morto tem comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos, conforme definido por InvalidPathChars.
- ou -
A extração de uma entrada de arquivo morto teria resultado em um arquivo de destino que está fora destinationDirectoryName (por exemplo, se o nome da entrada contiver acessadores de diretório pai).
- ou -
Uma entrada de arquivo morto tem o mesmo nome de uma entrada já extraída do mesmo arquivo.
O chamador não tem a permissão necessária.
destinationDirectoryName está em um formato inválido.
Uma entrada de arquivo morto não foi encontrada ou corrompida.
- ou -
Uma entrada de arquivo morto foi compactada usando um método de compactação que não tem suporte.
Comentários
Warning
Esse método não deve ser usado para extrair arquivos não confiáveis. Ele não impõe limites de tamanho, limites de contagem de entradas ou outras políticas necessárias para extração segura de arquivos não confiáveis. Para obter mais informações sobre como extrair arquivos com segurança de fontes não confiáveis, consulte As práticas recomendadas para usar arquivos zip e tar.
O diretório especificado por destinationDirectoryName ele já pode existir. Esse método cria o diretório de destino, seus diretórios pai ausentes e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, esse método não criará o diretório de destino.
O caminho tem permissão para especificar informações de caminho relativas ou absolutas. As informações de caminho relativo são interpretadas como relativas 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 no qual colocar os arquivos extraídos. O diretório já pode existir. Os diretórios ausentes são criados conforme necessário ao extrair entradas.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Retornos
Comentários
Warning
Esse método não deve ser usado para extrair arquivos não confiáveis. Ele não impõe limites de tamanho, limites de contagem de entradas ou outras políticas necessárias para extração segura de arquivos não confiáveis. Para obter mais informações sobre como extrair arquivos com segurança de fontes não confiáveis, consulte As práticas recomendadas para usar arquivos zip e tar.
O diretório especificado por destinationDirectoryName ele já pode existir. Esse método cria o diretório de destino, seus diretórios pai ausentes e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, esse método não criará o diretório de destino.
Cada arquivo extraído tem o mesmo caminho relativo para destinationDirectoryName o qual sua entrada de origem tem para a raiz do arquivo morto.
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 morto permanecerá parcialmente extraído.
Definido OverwriteFiles para true substituir arquivos existentes. O padrão é false, o que faz com que a extração gere um IOException arquivo se já existir um arquivo a ser extraído.
Use Password para fornecer a senha para entradas criptografadas.
EntryNameEncoding não é usado por essa sobrecarga. Os nomes de entrada e os comentários são decodificados usando a codificação especificada quando o source arquivo é aberto.
Links simbólicos no arquivo morto não são recriados como links simbólicos. Se destinationDirectoryName ou qualquer um de seus diretórios pai for uma junção pré-existente ou um link simbólico, o link será seguido e a extração será gravada na pasta de destino final.
As exceções que ocorrem durante a extração assíncrona são armazenadas na tarefa retornada e são geradas quando a tarefa é aguardada.
