ZipFileExtensions.ExtractToFileAsync 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 |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
De forma assíncrona, cria um ficheiro no sistema de ficheiros com o conteúdo da entrada e o nome especificado. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
De forma assíncrona, cria um ficheiro no sistema de ficheiros com o conteúdo da entrada e o nome especificado. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
De forma assíncrona, cria um ficheiro no sistema de ficheiros 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 do arquivo zip para extrair um ficheiro.
- destinationFileName
- String
O nome do ficheiro que irá conter o conteúdo da entrada.
- cancellationToken
- CancellationToken
O token de cancelamento para monitorizar pedidos de cancelamento.
Devoluções
Exceções
O interlocutor não tem a permissão necessária.
destinationFileName é 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.
-ou-
destinationFileName especifica um diretório.
destinationFileName é 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 em destinationFileName é inválido (por exemplo, está num disco não mapeado).
Ocorreu um erro de E/S.
-ou-
A entrada está atualmente aberta para escrita.
-ou-
A entrada foi apagada do arquivo.
destinationFileName está num formato inválido.
-ou-
O ZipArchive a que esta entrada pertence foi aberto em modo apenas de escrita.
A entrada está em falta no arquivo ou está corrompida e não pode ser lida.
-ou-
A entrada foi comprimida usando um método de compressão que não é suportado.
O ZipArchive a que esta entrada pertence foi descartado.
Observações
O caminho especificado pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual.
O último tempo de escrita do ficheiro é definido para o último tempo de escrita da entrada. Este método não permite sobrescrever um ficheiro existente com o mesmo nome. Tentar extrair diretórios explícitos (entradas com nomes que terminam em caracteres separadores de diretórios) não resultará na criação de um diretório.
Aplica-se a
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
De forma assíncrona, cria um ficheiro no sistema de ficheiros 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 do arquivo zip para extrair um ficheiro.
- destinationFileName
- String
O nome do ficheiro que irá conter o conteúdo da entrada.
- overwrite
- Boolean
true sobrescrever ficheiros; false caso contrário.
- cancellationToken
- CancellationToken
O token de cancelamento para monitorizar pedidos de cancelamento.
Devoluções
Exceções
O interlocutor não tem a permissão necessária.
destinationFileName é 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.
-ou-
destinationFileName especifica um diretório.
destinationFileName é 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 em destinationFileName é inválido (por exemplo, está num disco não mapeado).
Ocorreu um erro de E/S.
-ou-
A entrada está atualmente aberta para escrita.
-ou-
A entrada foi apagada do arquivo.
destinationFileName está num formato inválido.
-ou-
O ZipArchive a que esta entrada pertence foi aberto em modo apenas de escrita.
A entrada está em falta no arquivo ou está corrompida e não pode ser lida.
-ou-
A entrada foi comprimida usando um método de compressão que não é suportado.
O ZipArchive a que esta entrada pertence foi descartado.
Uma operação assíncrona é cancelada.
Observações
O caminho especificado pode especificar informação relativa ou absoluta do caminho. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual.
O último tempo de escrita do ficheiro é definido para o último tempo de escrita da entrada.
Este método permite sobrescrever um ficheiro existente com o mesmo nome.
