Class SharArchive
Nazwa przestrzeń: Aspose.Zip.Shar Zestawienie: Aspose.Zip.dll (25.5.0)
Ta klasa reprezentuje ostry plik archiwum.
public class SharArchive : IDisposableInheritance
Implements
Dziedziczeni członkowie
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
SharArchive()
Inicjalizuje nowy przykład klasy Aspose.Zip.Shar.SharArchive.
public SharArchive()Examples
Poniższy przykład pokazuje, jak kompresować plik.
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}SharArchive(strumień)
Inicjalizuje nową instancję klasy Aspose.Zip.Shar.SharArchive przygotowanej do dekompresji.
public SharArchive(string path)Parameters
path string
Droga do źródła archiwum.
Exceptions
path’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.
Dostęp do pliku path" jest odrzucony.
Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.
Plik w path’ zawiera kolumnę (:) w środku paska.
Plik nie został znaleziony.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Archiwum jest już otwarte.
Properties
Entries
Otrzymuje wpisy typu Aspose.Zip.Shar.SharEntry tworzącego archiwum.
public ReadOnlyCollection<sharentry> Entries { get; }Wartość nieruchomości
ReadOnlyCollection • < SharEntry >
Methods
CreateEntries(Złoty, Bool)
Dodaj do archiwum wszystkie pliki i katalogi ponownie w danym katalogu.
public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)Parameters
sourceDirectory string
Dyrekcja do kompresji.
includeRootDirectory bool
Oznacza, czy należy włączyć sam katalog korzeniowy, czy nie.
Returns
Wstęp do instancji.
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.
Wzywacz nie ma wymaganej zgody na dostęp do sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(Informacje, Bool)
Dodaj do archiwum wszystkie pliki i katalogi ponownie w danym katalogu.
public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)Parameters
directory DirectoryInfo
Dyrekcja do kompresji.
includeRootDirectory bool
Oznacza, czy należy włączyć sam katalog korzeniowy, czy nie.
Returns
Wstęp do instancji.
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.
Odwołujący nie ma wymaganej zgody na dostęp do adresatu directory”.
directory’ stands for a file, not for a directory.
CreateEntry(Źródło: FileInfo, Bool)
Tworzenie jednego wpisu w archiwum.
public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)Parameters
name string
Nazwa wejścia.
fileInfo FileInfo
Metadane plików lub folderów do kompresji.
openImmediately bool
Prawda jest taka, że jeśli natychmiast otworzysz plik, w przeciwnym razie otwórz plik na archiwum.
Returns
Wstęp do instancji.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.shar");
}Remarks
Jeśli plik zostanie natychmiast otwarty parametrem, zostanie on zablokowany, dopóki nie zostanie usunięty archiwum.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(String, String i Bool)
Tworzenie jednego wpisu w archiwum.
public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)Parameters
name string
Nazwa wejścia.
sourcePath string
Ścieżka do rejestracji do kompresji.
openImmediately bool
Prawda jest taka, że jeśli natychmiast otworzysz plik, w przeciwnym razie otwórz plik na archiwum.
Returns
Wstęp do instancji.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.shar");
}Remarks
Nazwa wpisu jest ustawiona wyłącznie w parametrze. nazwa pliku podana w parametrze nie wpływa na nazwę wpisu.
Jeśli plik zostanie natychmiast otwarty parametrem, zostanie on zablokowany, dopóki nie zostanie usunięty archiwum.
Exceptions
sourcePath’ is null.
Klient nie posiada wymaganego zezwolenia na dostęp.
sourcePath’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky. - lub - Nazwa pliku, jako część name’, przekracza 100 symboli.
Dostęp do pliku sourcePath’ jest odrzucony.
Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.
Plik w sourcePath’ zawiera kolumnę (:) w środku paska.
CreateEntry(strumień, strumień)
Tworzenie jednego wpisu w archiwum.
public SharEntry CreateEntry(string name, Stream source)Parameters
name string
Nazwa wejścia.
source Stream
Przepływ wejściowy dla wejścia.
Returns
Wstęp do instancji.
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)
Usuwa pierwsze pojawienie się określonego wpisu z listy wpisów.
public SharArchive DeleteEntry(SharEntry entry)Parameters
entry SharEntry
Wstęp do usunięcia z listy wpisów.
Returns
Wstęp do instancji.
Examples
Oto jak można usunąć wszystkie wpisy z wyjątkiem ostatniego:
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)
Usunąć wpis z listy wpisów według indeksu.
public SharArchive DeleteEntry(int entryIndex)Parameters
entryIndex int
Wskaźnik oparty na zero wejścia do usunięcia.
Returns
Archiwum z wpisem usunięte.
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)
Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Czy zarządzane zasoby powinny zostać usunięte?
Dispose()
Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.
public void Dispose()Save(strumień)
Zapisz archiwum do dostarczonego pliku docelowego.
public void Save(string destinationFileName)Parameters
destinationFileName string
Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.
Examples
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("archive.shar");
}Remarks
Istnieje możliwość przechowywania archiwum na tę samą ścieżkę, z której został pobrany. jednak nie jest to zalecane, ponieważ ten podejście wykorzystuje kopiowanie do tymczasowego pliku.
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.
Określenie destinationFileName’, nazwa pliku, lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.
Określenie destinationFileName’ jest nieważne, (na przykład, jest to na dysku bez mapowania).
Błąd I/O wystąpił podczas otwierania pliku.
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.
Plik nie został znaleziony.
Save(Stream)
Oszczędzaj archiwum na dostarczonym strumieniu.
public void Save(Stream output)Parameters
output Stream
Przepływ docelowy.
Examples
using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
using (var archive = new SharArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(sharFile);
}
}Remarks
Musi być pisemny.
Exceptions
output’ is null.
output’ is not writable. - or - output’ is the same stream we extract from.
