ZipFile.OpenReadAsync(String, CancellationToken) 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.
Abre assíncronamente a ZipArchive no caminho especificado para leitura. O ficheiro especificado é aberto com FileMode.Open.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchive> OpenReadAsync(string archiveFileName, System.Threading.CancellationToken cancellationToken = default);
static member OpenReadAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchive>
Public Shared Function OpenReadAsync (archiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchive)
Parâmetros
- archiveFileName
- String
Uma string que especifica o caminho no sistema de ficheiros para abrir o arquivo. 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.
- cancellationToken
- CancellationToken
O token de cancelamento para monitorizar pedidos de cancelamento.
Devoluções
Exceções
archiveFileName é 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.
Nome do arquivo é null.
O archiveFileName especificado excede 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 nome do arquivo especificado é inválido (por exemplo, está num disco não mapeado).
Um erro de E/S não especificado ocorreu durante a abertura do ficheiro.
archiveFileName especificava um diretório.
-ou-
O interlocutor não tem a permissão necessária.
O ficheiro especificado em archiveFileName não foi encontrado.
archiveFileName está num formato inválido.
O ficheiro especificado não podia ser interpretado como um ficheiro zip.
Uma operação assíncrona é cancelada.