Class CabArchive

Class CabArchive

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

Ta klasa reprezentuje plik archiwum cab.

public class CabArchive : IArchive, IDisposable

Dziedziczenie

objectCabArchive

Implementuje

IArchive, IDisposable

Członkowie dziedziczeni

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

Konstruktorzy

CabArchive(Stream)

Inicjalizuje nową instancję klasy Aspose.Zip.Cab.CabArchive i tworzy listę wpisów, które mogą być wyodrębnione z archiwum.

public CabArchive(Stream sourceStream)

Parametry

sourceStream Stream

Źródło archiwum. Musi być możliwe do przeszukiwania.

Przykłady

W poniższym przykładzie pokazano, jak wyodrębnić wszystkie wpisy do katalogu.

using (var archive = new CabArchive(File.OpenRead("archive.cab")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Uwagi

Ten konstruktor nie rozpakowuje żadnego wpisu. Zobacz metodę Aspose.Zip.Cab.CabEntry.Open, aby rozpakować.

Wyjątki

ArgumentNullException

sourceStream jest nullem.

ArgumentException

sourceStream nie jest możliwe do przeszukiwania.

InvalidDataException

sourceStream nie jest prawidłowym archiwum cab.

EndOfStreamException

Strumień jest zbyt krótki.

CabArchive(string)

Inicjalizuje nową instancję klasy Aspose.Zip.Cab.CabArchive i tworzy listę wpisów, które mogą być wyodrębnione z archiwum.

public CabArchive(string path)

Parametry

path string

Ścieżka do pliku archiwum.

Przykłady

W poniższym przykładzie pokazano, jak wyodrębnić wszystkie wpisy do katalogu.

using (var archive = new CabArchive("archive.cab")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Uwagi

Ten konstruktor nie rozpakowuje żadnego wpisu. Zobacz metodę Aspose.Zip.Cab.CabEntry.Open, aby rozpakować.

Wyjątki

ArgumentNullException

path jest nullem.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

Określona path, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system. Na przykład, na platformach opartych na 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

Określona ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

EndOfStreamException

Plik jest zbyt krótki.

Właściwości

Entries

Zwraca wpisy typu Aspose.Zip.Cab.CabEntry, które stanowią archiwum.

public ReadOnlyCollection<cabentry> Entries { get; }

Wartość właściwości

ReadOnlyCollection<CabEntry&gt;

Metody

Dispose(bool)

Wykonuje zadania zdefiniowane przez aplikację związane z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Czy zarządzane zasoby powinny być zwolnione.

Dispose()

Wykonuje zadania zdefiniowane przez aplikację związane z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów.

public void Dispose()

ExtractToDirectory(string)

Wyodrębnia wszystkie pliki w archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Ścieżka do katalogu, w którym mają być umieszczone wyodrębnione pliki.

Przykłady

using (var archive = new CabArchive("archive.cab")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

ArgumentNullException

path jest nullem

PathTooLongException

Określona ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

SecurityException

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

NotSupportedException

Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) nie będący częścią etykiety dysku (“C:").

ArgumentException

path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz sprawdzić nieprawidłowe znaki, korzystając z metody System.IO.Path.GetInvalidPathChars. -lub- path jest prefiksowany lub zawiera tylko znak dwukropka (:).

IOException

Katalog określony przez path jest plikiem. -lub- Nazwa sieci nie jest znana.

InvalidDataException

Archiwum jest uszkodzone.

 Polski