Class SharArchive
Der Name: Aspose.Zip.Shar Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse stellt eine scharfe Archivdatei dar.
public class SharArchive : IDisposableInheritance
Implements
Vererbte Mitglieder
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Shar.SharArchive Klasse.
public SharArchive()Examples
Das folgende Beispiel zeigt, wie man eine Datei komprimiert.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Initialisiert eine neue Instanz der Aspose.Zip.Shar.SharArchive-Klasse, die für die Decompression vorbereitet ist.
public SharArchive(string path)Parameters
path string
Der Weg zur Quelle des Archivs.
Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Die Datei ist nicht gefunden.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
Properties
Entries
Er erhält Beiträge von Aspose.Zip.Shar.SharEntry Typ, der das Archiv darstellt.
public ReadOnlyCollection<sharentry> Entries { get; }Eigentumswert
ReadOnlyCollection &undlt; SharEntry >
Methods
CreateEntries(String und Bool)
Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Verzeichnis zum Komprimieren.
includeRootDirectory bool
Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.
Returns
Eintrittsinstanz von Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(sharFile);
}
}Exceptions
sourceDirectory’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis zum Zugriff auf sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(VerzeichnisInfo, Bool)
Add to the archive all the files and directories recurrently in the given directory. - Add to the archive all the files and directories recurrently in the given directory.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Verzeichnis zum Komprimieren.
includeRootDirectory bool
Angibt, ob die Root-Dokumentation selbst enthalten ist oder nicht.
Returns
Eintrittsinstanz von Shar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(sharFile);
}
}Exceptions
directory’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis zum Zugriff auf directory'.
directory’ stands for a file, not for a directory.
CreateEntry(String, FileInfo und Bool)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Der Name des Eingangs.
fileInfo FileInfo
Die Metadaten von Datei oder Ordner zu komprimieren.
openImmediately bool
Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.
Returns
Eintrittsinstanz von Shar.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Wenn die Datei sofort mit dem Parameter geöffnet wird, wird sie blockiert, bis das Archiv gelöscht wird.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String und Bool)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Der Name des Eingangs.
sourcePath string
Der Weg zum Datei zu komprimieren.
openImmediately bool
Wahrlich, wenn Sie die Datei sofort öffnen, öffnen Sie sonst die Datei auf Archiv-Speicher.
Returns
Eintrittsinstanz von Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Der im Parameter angegebenen Dateiname beeinflusst nicht den Eingangsnamen.
Wenn die Datei sofort mit dem Parameter geöffnet wird, wird sie blockiert, bis das Archiv gelöscht wird.
Exceptions
sourcePath’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die sourcePath’ ist leer, enthält nur weiße Räume, oder enthält ungültige Zeichen. - oder - Dateiname, als Teil der name’, übersteigt 100 Symbole.
Der Zugriff auf die Datei sourcePath’ wird abgelehnt.
Die angegebenen sourcePath’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen Paths weniger als 248 Zeichen sein und Dateinamen müssen weniger als 260 Zeichen sein. - oder - name’ ist zu lang für schar.
Die Datei bei sourcePath’ enthält eine Kolonne (:) in der Mitte der Zeile.
CreateEntry(Strömung, Stream)
Erstellen Sie einen einzigen Eingang innerhalb des Archivs.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Der Name des Eingangs.
source Stream
Der Eingangstrom für den Eingang.
Returns
Eintrittsinstanz von Shar.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
archive.Save("archive.shar");
}Exceptions
name’ is null.
source’ is null.
name’ is empty.
DeleteEntry(SharEntry)
Entfernen Sie das erste Auftreten eines bestimmten Eintrags aus der Eintragsliste.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Eintritt zu entfernen aus der Eintrittsliste.
Returns
Eintrittsinstanz von Shar.
Examples
Hier ist, wie Sie alle Beiträge mit Ausnahme des letzten entfernen können:
using (var archive = new SharArchive("archive.shar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputSharFile);
}Exceptions
entry’ is null.
DeleteEntry(Int)
Entfernen Sie den Eingang aus der Eingangsliste durch Index.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Der null-basierte Index des Eingangs zu entfernen.
Returns
Das Archiv mit dem Eingang gelöscht.
Examples
using (var archive = new SharArchive("two_files.shar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.shar");
}Exceptions
entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.
Dispose(Bool)
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Ob verwaltete Ressourcen abgeschieden werden sollten.
Dispose()
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
public void Dispose()Save(String)
Speichern Sie das Archiv zu einem bereitgestellten Zieldatei.
public void Save(string destinationFileName)Parameters
destinationFileName string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Es ist möglich, ein Archiv auf dem gleichen Weg zu speichern, wie es heruntergeladen wurde. jedoch wird dies nicht empfohlen, weil dieser Ansatz Kopieren zu einer vorübergehenden Datei verwendet.
Exceptions
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
Die angegebenen destinationFileName’, Dateiname, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Spuren weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen sein.
Die angegebenen destinationFileName’ ist ungültig (z. B. auf einem unmapped-Drive).
Ein I/O-Fehler kam beim Öffnen der Datei auf.
destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.
destinationFileName’ is in an invalid format.
Die Datei ist nicht gefunden.
Save(Stream)
Speichern Sie Archive für den bereitgestellten Strom.
public void Save(Stream output)Parameters
output Stream
Der Destinationstrom.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Es muss geschrieben werden.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
