Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Representerar ett ISO-arkiv (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposable
Arv
Implementerar
Ärvda Medlemmar
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktörer
IsoArchive()
Initierar en ny instans av Aspose.Zip.Iso.IsoArchive-klassen och skapar ett tomt ISO-arkiv för att lägga till nya filer och kataloger.
public IsoArchive()
Exempel
Följande exempel visar hur man skapar ett nytt tomt ISO-arkiv och lägger till filer i det:
// Skapa ett nytt tomt ISO-arkiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Lägg till filer i ISO-arkivet
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Spara ISO-arkivet till en fil
isoArchive.Save("new_archive.iso");
}
IsoArchive(Stream, IsoLoadOptions)
Initierar en ny instans av Aspose.Zip.Iso.IsoArchive-klassen och komponerar en lista över poster som kan extraheras från arkivet.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)
Parametrar
sourceStream
Stream
Källan till arkivet. Den måste vara sökbar.
loadOptions
IsoLoadOptions
Alternativen för att ladda arkivet med.
Exempel
Följande exempel visar hur man extraherar alla poster till en katalog.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Kommentarer
Denna konstruktor packar inte upp några poster.
Undantag
sourceStream
är null.
sourceStream
är inte sökbar.
sourceStream
är inte ett giltigt ISO-arkiv.
IsoArchive(string, IsoLoadOptions)
Initierar en ny instans av Aspose.Zip.Iso.IsoArchive-klassen och komponerar en lista över poster som kan extraheras från arkivet.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)
Parametrar
path
string
Sökvägen till arkivfilen.
loadOptions
IsoLoadOptions
Alternativen för att ladda arkivet med.
Exempel
Följande exempel visar hur man extraherar alla poster till en katalog.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}
Kommentarer
Denna konstruktor packar inte upp några poster.
Undantag
path
är null.
Anroparen har inte den nödvändiga behörigheten för att få åtkomst.
path
är tom, innehåller bara vita tecken eller innehåller ogiltiga tecken.
Åtkomst till fil path
nekas.
Den angivna path
, filnamnet eller båda överskrider systemets definierade maximala längd. Till exempel, på Windows-baserade plattformar måste sökvägar vara kortare än 248 tecken och filnamn måste vara kortare än 260 tecken.
Fil på path
innehåller ett kolon (:) mitt i strängen.
Filens finns inte.
Den angivna sökvägen är ogiltig, till exempel att den ligger på en icke-mappad enhet.
Filens är redan öppen.
Filens är för kort.
Egenskaper
Entries
Hämtar poster av Aspose.Zip.Iso.IsoEntry-typ som utgör arkivet.
public ReadOnlyCollection<isoentry> Entries { get; }
Egenskapsvärde
ReadOnlyCollection<IsoEntry>
Metoder
CreateDirectory(string)
Lägger till en katalog i ISO-bilden.
public IsoEntry CreateDirectory(string name)
Parametrar
name
string
Sökvägen till katalogen i ISO.
Returer
Den sammansatta ISO-posten.
Undantag
Arkivet är öppnat för extrahering.
name
är null eller tom.
CreateEntry(string, string)
Lägger till en fil i ISO-bilden.
public IsoEntry CreateEntry(string name, string filePath)
Parametrar
name
string
Sökvägen till filen i ISO.
filePath
string
Sökvägen till filen.
Returer
Den sammansatta ISO-posten.
Undantag
filePath
är null.
filePath
är tom, innehåller bara vita tecken eller innehåller ogiltiga tecken.
Åtkomst till fil filePath
nekas.
Den angivna filePath
överskrider systemets definierade maximala längd. Till exempel, på Windows-baserade plattformar måste sökvägar vara kortare än 248 tecken och filnamn måste vara kortare än 260 tecken.
Fil på filePath
innehåller ett kolon (:) mitt i strängen.
Ett I/O-fel inträffade när filen öppnades.
CreateEntry(string, Stream)
Lägger till en fil i ISO-bilden.
public IsoEntry CreateEntry(string name, Stream source)
Parametrar
name
string
Sökvägen till filen i ISO.
source
Stream
Ström som innehåller filens data.
Returer
Den sammansatta ISO-posten.
CreateEntry(string)
Lägger till en fil i ISO-bilden.
public IsoEntry CreateEntry(string name)
Parametrar
name
string
Sökvägen till katalogen i ISO.
Returer
Den sammansatta ISO-posten.
Undantag
name
är null eller tom.
Arkivet är öppnat för extrahering.
Dispose()
Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.
public void Dispose()
ExtractToDirectory(string)
Extraherar alla poster till den angivna katalogen.
public void ExtractToDirectory(string destinationDirectory)
Parametrar
destinationDirectory
string
Katalogen att extrahera posterna till.
Exempel
Följande exempel visar hur man extraherar alla poster till en katalog:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
Undantag
Uppstår när arkivet är i redigeringsläge.
Uppstår när destinationDirectory
är null.
Save(string, IsoSaveOptions)
Sparar ISO-bilden till den angivna sökvägen.
public void Save(string path, IsoSaveOptions saveOptions = null)
Parametrar
path
string
Sökvägen där ISO-bilden kommer att sparas.
saveOptions
IsoSaveOptions
Alternativ för att spara ISO-arkivet med.
Exempel
Följande exempel visar hur man sparar ett ISO-arkiv till en fil:
// Skapa ett nytt tomt ISO-arkiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Lägg till filer i ISO-arkivet
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Spara ISO-arkivet till en fil
isoArchive.Save("new_archive.iso");
}
Undantag
Uppstår när arkivet inte är i redigeringsläge.
Uppstår när path
är null.
Uppstår när den angivna sökvägen är ogiltig, till exempel att den ligger på en icke-mappad enhet.
Uppstår när filen redan är öppen.
Uppstår när åtkomst till filen path
nekas.
Uppstår när den angivna path
överskrider systemets definierade maximala längd.
Save(Stream, IsoSaveOptions)
Sparar ISO-bilden till den angivna strömmen.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)
Parametrar
stream
Stream
Strömmen där ISO-bilden kommer att sparas.
saveOptions
IsoSaveOptions
Alternativ för att spara ISO-arkivet med.
Exempel
Följande exempel visar hur man sparar ett ISO-arkiv till en minnesström:
// Skapa ett nytt tomt ISO-arkiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Lägg till filer i ISO-arkivet
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Spara ISO-arkivet till en minnesström
isoArchive.Save(memoryStream);
}
Undantag
Uppstår när arkivet inte är i redigeringsläge.
Uppstår när stream
är null.
Uppstår när stream
inte är skrivbar.