TarEntry.ExtractToFile(String, Boolean) Método

Definição

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Origem:

TarEntry.cs

Extrai o arquivo ou diretório atual para o sistema de arquivos. Links simbólicos e links rígidos não são extraídos.

public:
 void ExtractToFile(System::String ^ destinationFileName, bool overwrite);

public void ExtractToFile (string destinationFileName, bool overwrite);

member this.ExtractToFile : string * bool -> unit

Public Sub ExtractToFile (destinationFileName As String, overwrite As Boolean)

Parâmetros

destinationFileName

String

O caminho para o arquivo de destino.

overwrite

Boolean

truese esse método deve substituir qualquer objeto de sistema de arquivos existente localizado no caminho; false para evitar a destinationFileName substituição.

Exceções

ArgumentNullException

destinationFileName é null.

ArgumentException

destinationFileName está vazio.

IOException

O diretório pai de destinationFileName não existe.

-ou-

overwrite é false e um arquivo já existe em destinationFileName.

-ou-

Existe um diretório com o mesmo nome que destinationFileName.

-ou-

Ocorreu um problema de E/S.

InvalidOperationException

Tentativa de extrair um link simbólico, um link rígido ou um tipo de entrada sem suporte.

UnauthorizedAccessException

Operação não permitida devido a permissões insuficientes.

Comentários

Arquivos do tipo BlockDevice, CharacterDeviceou Fifo só podem ser extraídos em plataformas Unix.

A elevação é necessária para extrair um ou CharacterDevice para o BlockDevice disco.

Links simbólicos podem ser recriados usando CreateSymbolicLink(String, String), CreateSymbolicLink(String, String)ou CreateAsSymbolicLink(String).

Links rígidos só podem ser extraídos ao usar ExtractToDirectory(Stream, String, Boolean) ou ExtractToDirectory(String, String, Boolean).