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.
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, 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.
- 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
O diretório especificado não deve existir. 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.
Esse método cria todos os subdiretórios e o diretório especificado, se necessário.
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.
- 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 criará todos os subdiretórios e o diretório especificado, se necessário.
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
O diretório especificado não deve existir. 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.
