Compartilhar via


Método ZipArchive.ExtractToDirectory (String, String)

Em todos os arquivos no arquivamento especificado para um diretório de sistema de arquivos. O diretório especificado não deve existir. Este método criará todos os subdiretórios e o diretório especificado. Se houver um erro ao extrair o arquivo, o arquivo neutro permanecerá parcialmente extraído. Cada entrada será extraída forma que o arquivo extraído tem o mesmo caminho relativo para o destinationDirectoryName como entrada tem que 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. Se um arquivo a ser as tem um horário inválido da última modificação, o primeiro datetime representável no formato de carimbo de data/hora zip (meia-noite) o 1º de janeiro de 1980 será usado.

Namespace:  Microsoft.TeamFoundation.Server.Core
Assembly:  Microsoft.TeamFoundation.Server.Core (em Microsoft.TeamFoundation.Server.Core.dll)

Sintaxe

'Declaração
Public Shared Sub ExtractToDirectory ( _
    sourceArchiveFileName As String, _
    destinationDirectoryName As String _
)
public static void ExtractToDirectory(
    string sourceArchiveFileName,
    string destinationDirectoryName
)

Parâmetros

  • sourceArchiveFileName
    Tipo: System.String
    O caminho para o arquivo neutro no sistema de arquivos que deve ser extraído.
  • destinationDirectoryName
    Tipo: System.String
    O caminho para o diretório de sistema de arquivos.O diretório especificado não deve existir, mas o diretório que está contido em deve existir.

Exceções

Exceção Condição
ArgumentException

sourceArchive ou destinationDirectoryName é uma cadeia de caracteres de comprimento zero, contém somente espaço em branco, ou contém um ou mais caracteres inválidos conforme definido por InvalidPathChars.

ArgumentNullException

sourceArchive ou destinationDirectoryName é nulo.

PathTooLongException

sourceArchive ou destinationDirectoryName especifica um caminho, nome de arquivo, ou ambos excede o comprimento máximo definidos definido. 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 por sourceArchive ou por destinationDirectoryName é inválido, (por exemplo, está em uma unidade unmapped).

IOException

O diretório especificado por destinationDirectoryName já existe. - ou um erro de E/S ocorreu. - ou um nome de entrada do arquivamento é de comprimento zero, contém somente espaço em branco, ou contém um ou mais caracteres inválidos como definido por InvalidPathChars. - ou extrair uma entrada do arquivamento resultaria em um destino do arquivo que está fora do diretório de destino (por exemplo, devido aos acessadores do diretório pai). - ou uma entrada do arquivamento tem o mesmo nome que uma entrada já extraído do mesmo arquivo neutro.

UnauthorizedAccessException

O chamador não tem a permissão necessária.

NotSupportedException

sourceArchive ou destinationDirectoryName está em um formato inválido.

FileNotFoundException

sourceArchive não foi encontrado.

InvalidDataException

O arquivo neutro especificado por sourceArchive: Não é um ZipArchive válido - ou uma entrada do arquivamento não foi encontrada ou era corrompido. - ou uma entrada do arquivamento foi compactada usando um método de compactação que não é suportado.

Segurança do .NET Framework

Consulte também

Referência

ZipArchive Classe

Sobrecargas ExtractToDirectory

Namespace Microsoft.TeamFoundation.Server.Core