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
Implementuje
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
sourceStream
jest nullem.
sourceStream
nie jest możliwe do przeszukiwania.
sourceStream
nie jest prawidłowym archiwum cab.
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
path
jest nullem.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku path
jest zabroniony.
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.
Plik w path
zawiera dwukropek (:) w środku ciągu.
Plik nie został znaleziony.
Określona ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
Plik jest już otwarty.
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>
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
path jest nullem
Określona ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.
Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.
Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) nie będący częścią etykiety dysku (“C:").
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 (:).
Katalog określony przez path jest plikiem. -lub- Nazwa sieci nie jest znana.
Archiwum jest uszkodzone.