Construtor ZipArchive (String, ZipArchiveMode)
Abre um ZipArchive no caminho especificado no modo de ZipArchiveMode especificado.
Namespace: Microsoft.TeamFoundation.Server.Core
Assembly: Microsoft.TeamFoundation.Server.Core (em Microsoft.TeamFoundation.Server.Core.dll)
Sintaxe
'Declaração
Public Sub New ( _
archiveFileName As String, _
mode As ZipArchiveMode _
)
public ZipArchive(
string archiveFileName,
ZipArchiveMode mode
)
Parâmetros
- archiveFileName
Tipo: System.String
Uma cadeia de caracteres que especifica o caminho no sistema de arquivos para abrir sobre o arquivo neutro.O caminho é permitido para especificar as informações de caminho relativo ou absoluto.As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual.
- mode
Tipo: Microsoft.TeamFoundation.Server.Core.ZipArchiveMode
Consulte a descrição enum de ZipArchiveMode.Se a leitura é especificada, o arquivo é aberto com System.IO.FileMode.Open, e irá acionar um FileNotFoundException se o arquivo não existe.Se Create é especificada, o arquivo é aberto com System.IO.FileMode.CreateNew, e irá acionar um System.IO.IOException se o arquivo já existe.Se a atualização for especificada, o arquivo é aberto com System.IO.FileMode.OpenOrCreate.Se o arquivo existe e é arquivo ZIP, suas entradas tornar-se-ão acessíveis, e podem ser alteradas, e as novas entradas podem ser criadas.Se o arquivo existe e não é um arquivo ZIP, um ZipArchiveException será lançada.Se o arquivo existe e está vazia ou não existe, um novo arquivo ZIP será criado.Observe que cria um arquivo ZIP com o modo de ZipArchiveMode.Create é mais eficiente para criar um novo arquivo ZIP.
Exceções
Exceção | Condição |
---|---|
ArgumentException | o caminho é uma cadeia de caracteres de comprimento zero, contém somente espaço em branco, ou contém um ou mais caracteres inválidos como definido por InvalidPathChars. |
ArgumentNullException | o caminho é nulo. |
PathTooLongException | O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema. Por exemplo, em plataformas com base no Windows, os caminhos devem ter menos que 248 caracteres e os nomes de arquivo devem ter menos que 260 caracteres. |
DirectoryNotFoundException | O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada). |
IOException | Um erro de E/S ocorreu ao abrir o arquivo. |
UnauthorizedAccessException | o caminho especificado um diretório. -ou- O chamador não tem a permissão necessária. |
ArgumentOutOfRangeException | o modo especificou um valor inválido. |
FileNotFoundException | O arquivo especificado no caminho não foi encontrado. |
NotSupportedException | o caminho está em um formato inválido. |
InvalidDataException | O arquivo especificado não pôde ser interpretado como um arquivo ZIP. - ou modo é a atualização e uma entrada está faltando do arquivamento ou estiver corrompida e não pode ser lido. - ou modo é a atualização e uma entrada é muito grande caber na memória. |
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.