Class SharArchive
De naam: Aspose.Zip.Shar Verzameling: Aspose.Zip.dll (25.5.0)
Deze klasse is een scherpe archiefbestand.
public class SharArchive : IDisposableInheritance
Implements
Geëerbiede leden
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Initialiseert een nieuwe instantie van de Aspose.Zip.Shar.SharArchive klasse.
public SharArchive()Examples
Het volgende voorbeeld laat zien hoe u een bestand kunt compresseren.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(String)
Initialiseert een nieuwe instantie van de Aspose.Zip.Shar.SharArchive-klasse voorbereid voor decompressie.
public SharArchive(string path)Parameters
path string
De weg naar de bron van het archief.
Exceptions
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
Het bestand op path’ bevat een kolom (:) in het midden van de string.
Het bestand is niet gevonden.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is al open.
Properties
Entries
Geeft input van Aspose.Zip.Shar.SharEntry type die het archief vormt.
public ReadOnlyCollection<sharentry> Entries { get; }Eigendomswaarde
ReadOnlyCollection < SharEntry >
Methods
CreateEntries(String en Bool)
Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Directory voor compressie.
includeRootDirectory bool
Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.
Returns
Inschrijving in de instantie.
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.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
De aangegeven pad, bestandnaam, of beide overschrijden de systeemdefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, paden moeten minder dan 248 tekens, en bestandnamen moeten minder dan 260 tekens.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DirectoryInfo, Bool)
Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Directory voor compressie.
includeRootDirectory bool
Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.
Returns
Inschrijving in de instantie.
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.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot directory'.
directory’ stands for a file, not for a directory.
CreateEntry(String, FileInfo en Bool)
Creëren van een enkele ingang binnen het archief.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
De naam van de ingang.
fileInfo FileInfo
De metadata van het bestand of de map om te worden gecomprimeerd.
openImmediately bool
Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.
Returns
Inschrijving in de instantie.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String en Bool)
Creëren van een enkele ingang binnen het archief.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
De naam van de ingang.
sourcePath string
De weg naar het bestanden om gecomprimeerd te worden.
openImmediately bool
Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.
Returns
Inschrijving in de instantie.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
De invoernaam is uitsluitend ingesteld binnen de parameter.De in de parameter verstrekte bestandnaam beïnvloedt de invoernaam niet.
Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.
Exceptions
sourcePath’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De sourcePath’ is leeg, bevat alleen witte ruimtes, of bevat ongeldig tekens. - of - File name, als onderdeel van name’, overschrijdt 100 symbolen.
De toegang tot het bestand sourcePath’ wordt geweigerd.
De aangegeven sourcePath’, bestandnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens zijn en bestandnamen moeten minder dan 260 tekens zijn. - of - name’ is te lang voor scherp.
Het bestand bij sourcePath’ bevat een kolom (:) in het midden van de string.
CreateEntry(Stream , Stream)
Creëren van een enkele ingang binnen het archief.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
De naam van de ingang.
source Stream
De ingangstromen voor de ingang.
Returns
Inschrijving in de instantie.
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)
Verwijder de eerste verschijning van een specifieke ingang uit de inganglijst.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
De ingang om te verwijderen uit de inganglijst.
Returns
Inschrijving in de instantie.
Examples
Hier is hoe u alle inschrijvingen kunt verwijderen met uitzondering van de laatste:
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)
Verwijder de ingang van de inganglijst door index.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
De nulgebaseerde index van de ingang te verwijderen.
Returns
Het archief met de ingang is verwijderd.
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)
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Of de beheerde middelen moeten worden afgebroken.
Dispose()
Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.
public void Dispose()Save(String)
Speel archief op een bestand van bestemming.
public void Save(string destinationFileName)Parameters
destinationFileName string
De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Het is mogelijk om een archief op te slaan op dezelfde route als het is geladen van. echter, dit is niet aanbevolen omdat deze benadering gebruikt het kopiëren naar een tijdelijke bestand.
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.
De aangegeven destinationFileName’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.
De aangegeven destinationFileName’ is invalid, (bijvoorbeeld, het is op een niet-mapped schijf).
Een I/O-fout vond plaats tijdens het openen van het bestand.
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.
Het bestand is niet gevonden.
Save(Stream)
Speel archief op de geleverde stroom.
public void Save(Stream output)Parameters
output Stream
De bestemming stroom.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
moet geschreven zijn.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
