Compartilhar via


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

Consulte também

Referência

ZipArchive Classe

Sobrecargas ZipArchive

Namespace Microsoft.TeamFoundation.Server.Core