ZipFileExtensions.ExtractToFileAsync 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 |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- source
- ZipArchiveEntry
A entrada de arquivo zip da qual extrair um arquivo.
- destinationFileName
- String
O nome do arquivo que conterá o conteúdo da entrada.
- cancellationToken
- CancellationToken
O token de cancelamento a ser monitorado para solicitações de cancelamento.
Retornos
Exceções
O chamador não tem a permissão necessária.
destinationFileName é 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.
- ou -
destinationFileName especifica um diretório.
destinationFileName é 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 é destinationFileName inválido (por exemplo, ele está em uma unidade não mapeada).
Ocorreu um erro de E/S.
- ou -
No momento, a entrada está aberta para gravação.
- ou -
A entrada foi excluída do arquivo morto.
destinationFileName está em um formato inválido.
- ou -
O ZipArchive ao qual essa entrada pertence foi aberto em um modo somente gravação.
A entrada está ausente do arquivo morto ou está corrompida e não pode ser lida.
- ou -
A entrada foi compactada usando um método de compactação que não tem suporte.
O ZipArchive ao qual essa entrada pertence foi descartado.
Comentários
O caminho especificado 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.
A hora da última gravação do arquivo é definida como a última hora de gravação da entrada. Esse método não permite a substituição de um arquivo existente com o mesmo nome. A tentativa de extrair diretórios explícitos (entradas com nomes que terminam em caracteres separadores de diretório) não resultará na criação de um diretório.
Aplica-se a
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- source
- ZipArchiveEntry
A entrada de arquivo zip da qual extrair um arquivo.
- destinationFileName
- String
O nome do arquivo que conterá o conteúdo da entrada.
- overwrite
- 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
O chamador não tem a permissão necessária.
destinationFileName é 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.
- ou -
destinationFileName especifica um diretório.
destinationFileName é 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 é destinationFileName inválido (por exemplo, ele está em uma unidade não mapeada).
Ocorreu um erro de E/S.
- ou -
No momento, a entrada está aberta para gravação.
- ou -
A entrada foi excluída do arquivo morto.
destinationFileName está em um formato inválido.
- ou -
O ZipArchive ao qual essa entrada pertence foi aberto em um modo somente gravação.
A entrada está ausente do arquivo morto ou está corrompida e não pode ser lida.
- ou -
A entrada foi compactada usando um método de compactação que não tem suporte.
O ZipArchive ao qual essa entrada pertence foi descartado.
Uma operação assíncrona é cancelada.
Comentários
O caminho especificado 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.
A hora da última gravação do arquivo é definida como a última hora de gravação da entrada.
Esse método permite a substituição de um arquivo existente com o mesmo nome.
