Class IsoArchive

sourceStream jest null.

sourceStream nie jest z możliwością przeszukiwania.

InvalidDataException

sourceStream nie jest ważnym archiwum ISO.

IsoArchive(string, IsoLoadOptions)

Inicjalizuje nową instancję klasy Aspose.Zip.Iso.IsoArchive i tworzy listę wpisów, które mogą być wydobyte z archiwum.

public IsoArchive(string path, IsoLoadOptions loadOptions = null)

Parametry

path string

Ścieżka do pliku archiwum.

loadOptions IsoLoadOptions

Opcje do załadowania archiwum.

Przykłady

Poniższy przykład pokazuje, jak wydobyć wszystkie wpisy do katalogu.

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

Uwagi

Ten konstruktor nie rozpakowuje żadnego wpisu.

Wyjątki

path jest null.

SecurityException

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

UnauthorizedAccessException

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

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 za krótki.

Właściwości

Entries

Pobiera wpisy typu Aspose.Zip.Iso.IsoEntry, które tworzą archiwum.

public ReadOnlyCollection<isoentry> Entries { get; }

Wartość właściwości

ReadOnlyCollection<IsoEntry>

Metody

CreateDirectory(string)

Dodaje katalog do obrazu ISO.

public IsoEntry CreateDirectory(string name)

Parametry

name string

Ścieżka katalogu w ISO.

Zwraca

Skomponowany wpis ISO.

Wyjątki

Archiwum jest otwarte do wydobycia.

name jest null lub pusty.

CreateEntry(string, string)

Dodaje plik do obrazu ISO.

public IsoEntry CreateEntry(string name, string filePath)

Parametry

name string

Ścieżka pliku w ISO.

filePath string

Ścieżka pliku.

Zwraca

Skomponowany wpis ISO.

Wyjątki

filePath jest null.

UnauthorizedAccessException

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

Dostęp do pliku filePath jest zabroniony.

PathTooLongException

Określona filePath przekracza 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 filePath zawiera dwukropek (:) w środku ciągu.

IOException

Wystąpił błąd I/O podczas otwierania pliku.

CreateEntry(string, Stream)

Dodaje plik do obrazu ISO.

public IsoEntry CreateEntry(string name, Stream source)

Parametry

name string

Ścieżka pliku w ISO.

source Stream

Strumień zawierający dane pliku.

Zwraca

Skomponowany wpis ISO.

CreateEntry(string)

Dodaje plik do obrazu ISO.

public IsoEntry CreateEntry(string name)

Parametry

name string

Ścieżka katalogu w ISO.

Zwraca

Skomponowany wpis ISO.

Wyjątki

name jest null lub pusty.

Archiwum jest otwarte do wydobycia.

Dispose()

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

public void Dispose()

ExtractToDirectory(string)

Wydobywa wszystkie wpisy do określonego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Katalog, do którego zostaną wydobyte wpisy.

Przykłady

Poniższy przykład pokazuje, jak wydobyć wszystkie wpisy do katalogu:

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

Wyjątki

Rzucony, gdy archiwum jest w trybie edycji.

Rzucony, gdy destinationDirectory jest null.

Save(string, IsoSaveOptions)

Zapisuje obraz ISO do określonej ścieżki.

public void Save(string path, IsoSaveOptions saveOptions = null)

Parametry

path string

Ścieżka, w której obraz ISO zostanie zapisany.

saveOptions IsoSaveOptions

Opcje do zapisania archiwum ISO.

Przykłady

Poniższy przykład pokazuje, jak zapisać archiwum ISO do pliku:

// Utwórz nowe puste archiwum ISO
using(IsoArchive isoArchive = new IsoArchive())
{
    // Dodaj pliki do archiwum ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Zapisz archiwum ISO do pliku
    isoArchive.Save("new_archive.iso");
}

Wyjątki

Rzucony, gdy archiwum nie jest w trybie edycji.

DirectoryNotFoundException

Rzucony, gdy path jest null.

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

IOException

Rzucony, gdy plik jest już otwarty.

UnauthorizedAccessException

Rzucony, gdy dostęp do pliku path jest zabroniony.

PathTooLongException

Rzucony, gdy określona path przekracza maksymalną długość zdefiniowaną przez system.

Save(Stream, IsoSaveOptions)

Zapisuje obraz ISO do określonego strumienia.

public void Save(Stream stream, IsoSaveOptions saveOptions = null)

Parametry

stream Stream

Strumień, w którym obraz ISO zostanie zapisany.

saveOptions IsoSaveOptions

Opcje do zapisania archiwum ISO.

Przykłady

Poniższy przykład pokazuje, jak zapisać archiwum ISO do strumienia pamięci:

// Utwórz nowe puste archiwum ISO
using(IsoArchive isoArchive = new IsoArchive())
{
    // Dodaj pliki do archiwum ISO
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Zapisz archiwum ISO do strumienia pamięci
    isoArchive.Save(memoryStream);
}

Wyjątki

Rzucony, gdy archiwum nie jest w trybie edycji.

Rzucony, gdy stream jest null.