Class SharArchive
Namn på plats: Aspose.Zip.Shar Sammanfattning: Aspose.Zip.dll (25.5.0)
Denna klass representerar en skarp arkivfil.
public class SharArchive : IDisposableInheritance
Implements
Arvsmedlemmar
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Initialiserar en ny instans av Aspose.Zip.Shar.SharArchive klass.
public SharArchive()Examples
Följande exempel visar hur man komprimerar en fil.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(Sträng)
Initialiserar en ny instans av Aspose.Zip.Shar.SharArchive klass förberedd för dekomprimering.
public SharArchive(string path)Parameters
path string
Vägen till källan till arkivet.
Exceptions
path’ is null.
Sökanden har inte behörig tillstånd att komma åt.
path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.
Tillgång till filen path" vägras.
Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.
Filen på path’ innehåller en kolumn (:) i mitten av raden.
Filen hittades inte.
Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.
Filen är redan öppen.
Properties
Entries
Få inmatningar av Aspose.Zip.Shar.SharEntry-typ som utgör arkivet.
public ReadOnlyCollection<sharentry> Entries { get; }Fastighetsvärde
ReadOnlyCollection ochlt; SharEntry >
Methods
CreateEntries(String och bool)
Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
katalog för komprimering.
includeRootDirectory bool
Anger om du ska inkludera rötdiagrammet själv eller inte.
Returns
Shar inträdesinstans.
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.
Ringaren har inte nödvändig tillstånd att komma åt sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamnen måste vara mindre än 260 tecken.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Föregående inlägg: Bool)
Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
katalog för komprimering.
includeRootDirectory bool
Anger om du ska inkludera rötdiagrammet själv eller inte.
Returns
Shar inträdesinstans.
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.
Ringaren har inte nödvändig tillstånd att komma åt direktory”.
directory’ stands for a file, not for a directory.
CreateEntry(sträng, FileInfo, bool)
Skapa en enda inmatning inom arkivet.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Namnet på ingången.
fileInfo FileInfo
Metadata av filen eller mappen ska komprimeras.
openImmediately bool
Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.
Returns
Shar inträdesinstans.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String och Bool)
Skapa en enda inmatning inom arkivet.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Namnet på ingången.
sourcePath string
Vägen att filera för att komprimeras.
openImmediately bool
Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.
Returns
Shar inträdesinstans.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Innehållsnamnet anges endast inom parameter. filnamnet som anges i parameter påverkar inte innehållsnamnet.
Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.
Exceptions
sourcePath’ is null.
Sökanden har inte behörig tillstånd att komma åt.
sourcePath’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken. - eller - Filnamn, som en del av name’, överstiger 100 symboler.
Tillgång till filen sourcePath’ vägras.
Den angivna sourcePath’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken. - eller - name’ är för lång för skarp.
Filen i sourcePath’ innehåller en kolumn (:) i mitten av raden.
CreateEntry(Ström, ström)
Skapa en enda inmatning inom arkivet.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Namnet på ingången.
source Stream
Inträdesflöde för ingången.
Returns
Shar inträdesinstans.
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)
Ta bort den första förekomsten av en viss inmatning från inmatningslistan.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Inträde att ta bort från listan inträde.
Returns
Shar inträdesinstans.
Examples
Här är hur du kan ta bort alla poster utom den sista:
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)
Ta bort inmatningen från inmatningslistan per index.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Nollbaserad index för inmatning att ta bort.
Returns
Arkivet med ingången raderas.
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)
Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Oavsett om de förvaltade resurserna ska utplånas.
Dispose()
Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.
public void Dispose()Save(Sträng)
Spara arkiv till en avsedd fil som tillhandahålls.
public void Save(string destinationFileName)Parameters
destinationFileName string
Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Det är möjligt att spara ett arkiv på samma väg som det laddades från. Detta rekommenderas dock inte eftersom denna metod använder kopiering till en tillfällig fil.
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.
Den angivna destinationFileName’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.
Den angivna destinationFileName’ är ogiltig (t.ex. den är på en outmappad enhet).
Ett I/O-fel inträffade när du öppnade filen.
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.
Filen hittades inte.
Save(Stream)
Spara arkiv till den tillhandahållna strömmen.
public void Save(Stream output)Parameters
output Stream
Destination strömmar.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Måste vara skribar.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
