Class TarEntry

Class TarEntry

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Reprezentuje pojedynczy plik w archiwum tar.

public class TarEntry : IArchiveFileEntry

Dziedziczenie

object ← TarEntry

Implementuje

IArchiveFileEntry

Członkowie dziedziczeni

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Właściwości

IsDirectory

Zwraca wartość wskazującą, czy wpis reprezentuje katalog.

public bool IsDirectory { get; }

Wartość właściwości

bool

Length

Zwraca długość wpisu w bajtach.

public long Length { get; }

Wartość właściwości

long

Name

Zwraca lub ustawia nazwę wpisu w archiwum.

public string Name { get; set; }

Wartość właściwości

string

Metody

Extract(string)

Wydobywa wpis do systemu plików według podanej ścieżki.

public FileSystemInfo Extract(string path)

Parametry

path string

Ścieżka do pliku docelowego. Jeśli plik już istnieje, zostanie nadpisany.

Zwraca

FileSystemInfo

Informacje o pliku skomponowanym.

Przykłady 

using (var archive = new TarArchive("archive.tar"))
{
    archive.Entries[0].Extract("data.bin");
}

Wyjątki

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

path jest pusty, zawiera tylko spacje lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

Podana path, nazwa pliku lub obie przekraczają maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

NotSupportedException

Plik w path zawiera dwukropek (:) w środku ciągu.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Podana ścieżka jest nieprawidłowa, na przykład znajduje się na niezmapowanym dysku.

IOException

Plik jest już otwarty.

Extract(Stream)

Wydobywa wpis do podanego strumienia.

public void Extract(Stream destination)

Parametry

destination Stream

Strumień docelowy. Musi być zapisywalny.

Przykłady

Wydobycie wpisu z archiwum tar.

using (var archive = new TarArchive("archive.tar"))
{
    archive.Entries[0].Extract(httpResponseStream);
}

Wyjątki

ArgumentException

destination nie obsługuje zapisu.

Open()

Otwiera wpis do wydobycia i udostępnia strumień z zawartością wpisu.

public Stream Open()

Zwraca

Stream

Strumień, który reprezentuje zawartość wpisu.

Przykłady

Użycie: Stream decompressed = entry.Open();

.NET 4.0 i wyżej - użyj metody Stream.CopyTo: decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 i wcześniej - skopiuj bajty ręcznie:

byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
 fileStream.Write(buffer, 0, bytesRead);
```</p>

#### Uwagi

Odczytaj ze strumienia, aby uzyskać oryginalną zawartość pliku. Zobacz sekcję przykładów.
 Polski