Class SharArchive

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

UnauthorizedAccessException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

Tilgang til filen path’ er nægtet.

DirectoryNotFoundException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

Filen er allerede åben.

`Properties`

`Entries`

Få indtægter af Aspose.Zip.Shar.SharEntry type, der udgør arkivet.

public ReadOnlyCollection<sharentry> Entries { get; }

`Ejendomsværdi`

ReadOnlyCollection < SharEntry >

`Methods`

`CreateEntries(String og Bool)`

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

public SharArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

`Parameters`

sourceDirectory string

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

`Returns`

Indtastning af indtastning.

`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.

Ringeren har ikke den nødvendige tilladelse til at få adgang til sourceDirectory'.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

Den angivne vej, filnavn, eller begge overskrider den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal vejene være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. Den angivne vej, filnavn, eller begge er for lange.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(Anmeldelse: Bool)`

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

public SharArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

`Parameters`

directory DirectoryInfo

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

`Returns`

Indtastning af indtastning.

`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.

Ringeren har ikke den nødvendige tilladelse til at få adgang til direktory'.

directory’ stands for a file, not for a directory.

`CreateEntry(String, FileInfo og Bool)`

Skab en enkelt indgang i arkivet.

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

`Parameters`

name string

Navnet på indgangen.

fileInfo FileInfo

Metadata af filen eller mappen skal komprimeres.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

`Returns`

SharEntry

Indtastning af indtastning.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.shar");
}

`Remarks`

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(String, String og Bool)`

Skab en enkelt indgang i arkivet.

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

Navnet på indgangen.

sourcePath string

Vejen til fil at blive komprimeret.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

`Returns`

SharEntry

Indtastning af indtastning.

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.shar");
}

`Remarks`

Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

`Exceptions`

sourcePath’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

UnauthorizedAccessException

code class=“paramref”>sourcePath’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn. - eller - Filnavn, som en del af name’, overstiger 100 symboler.

Tilgang til filen sourcePath’ er nægtet.

Den angivne sourcePath’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. - eller - name’ er for lang til skarp.

NotSupportedException

Filen på sourcePath’ indeholder en kolonne (:) i midten af ringen.

`CreateEntry(Strøm, Strøm)`

Skab en enkelt indgang i arkivet.

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

Navnet på indgangen.

source Stream

Indtægtsstrøm for indtægten.

`Returns`

SharEntry

Indtastning af indtastning.

`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)`

Det fjerner den første forekomst af en bestemt indtastning fra indtastningslisten.

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

Indtægten skal fjernes fra listen over indtægter.

`Returns`

Indtastning af indtastning.

`Examples`

Her er, hvordan du kan fjerne alle indtægter undtagen den sidste:

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(Int)`

Fjern indtægten fra indtægtslisten ved indeks.

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

Det nulbaserede indeks af indtægten skal fjernes.

`Returns`

ArgumentOutOfRangeException

Arkivet med indgangen er slettet.

`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)`

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Om de forvaltede ressourcer skal fjernes.

`Dispose()`

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

`Save(String)`

Sparer arkiver til en bestemmelsesfil, der er leveret.

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

`Examples`

using (var archive = new SharArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.shar");
}

`Remarks`

Det er muligt at gemme et arkiv på samme vej, som det blev lastet fra. dog anbefales dette ikke, fordi denne tilgang bruger kopiering til en midlertidig 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.

DirectoryNotFoundException

Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

Den angivne destinationFileName’ er ugyldig (f.eks. den er på en ikke-mapped disk).

UnauthorizedAccessException

En I/O-fejl opstod under åbningen af 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.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

Filen er ikke fundet.

`Save(Stream)`

Sparer arkiver til den leverede strøm.

public void Save(Stream output)

`Parameters`

output Stream

Destinationstrøm.

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

Det skal være skriftligt.

`Exceptions`

output’ is null.