Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Tato třída představuje uuencoded soubor.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Dědičnost
Implementuje
IArchive, IDisposable, IArchiveFileEntry
Děděné členy
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktory
UueArchive()
Inicializuje novou instanci třídy Aspose.Zip.Uue.UueArchive připravenou pro kódování.
public UueArchive()
Příklady
Následující příklad ukazuje, jak uuencode soubor.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Inicializuje novou instanci třídy Aspose.Zip.Uue.UueArchive připravenou pro dekódování.
public UueArchive(Stream sourceStream)
Parametry
sourceStream
Stream
Zdroj archivu.
Příklady
Otevřete archiv ze streamu a extrahujte ho do MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Poznámky
Tento konstruktor neprovádí dekódování. Viz metoda Aspose.Zip.Uue.UueArchive.Open pro dekompresi.
UueArchive(string)
Inicializuje novou instanci třídy Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)
Parametry
path
string
Cesta k souboru archivu.
Příklady
Otevřete archiv ze souboru podle cesty a dekódujte ho do MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Poznámky
Tento konstruktor neprovádí dekompresi. Viz metoda Aspose.Zip.Uue.UueArchive.Open pro dekompresi.
Výjimky
path
je null.
Volající nemá požadované oprávnění pro přístup.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
Určená path
, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
Vlastnosti
Name
Název původního souboru.
public string Name { get; }
Hodnota vlastnosti
Metody
Dispose()
Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.
public void Dispose()
Dispose(bool)
Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.
protected virtual void Dispose(bool disposing)
Parametry
disposing
bool
Zda by měly být uvolněny řízené prostředky.
Extract(Stream)
Extrahuje archiv do poskytnutého streamu.
public void Extract(Stream destination)
Parametry
destination
Stream
Cílový stream. Musí být zapisovatelný.
Příklady
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Výjimky
destination
nepodporuje zápis.
Extract(string)
Extrahuje archiv do souboru podle cesty.
public FileInfo Extract(string path)
Parametry
path
string
Cesta k cílovému souboru. Pokud soubor již existuje, bude přepsán.
Návrat
Info o extrahovaném souboru.
Výjimky
path
je null.
Volající nemá požadované oprávnění pro přístup.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
Určená path
, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
Soubor nebyl nalezen.
Určená cesta je neplatná, například je na nepřiřazeném disku.
Soubor je již otevřen.
ExtractToDirectory(string)
Extrahuje obsah archivu do poskytnutého adresáře.
public void ExtractToDirectory(string destinationDirectory)
Parametry
destinationDirectory
string
Cesta k adresáři, do kterého budou umístěny extrahované soubory.
Poznámky
Pokud adresář neexistuje, bude vytvořen.
Výjimky
destinationDirectory
je null.
Určená cesta, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Volající nemá požadované oprávnění pro přístup k existujícímu adresáři.
Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").
destinationDirectory
je řetězec s nulovou délkou, obsahuje pouze bílé znaky nebo obsahuje jeden nebo více neplatných znaků. Neplatné znaky můžete zjistit pomocí metody System.IO.Path.GetInvalidPathChars.
-nebo- cesta je předřazena nebo obsahuje pouze znak dvojtečky (:).
Adresář určený cestou je soubor. -nebo- Síťový název není znám.
Open()
Otevře archiv pro dekódování a poskytne stream s obsahem archivu.
public Stream Open()
Návrat
Stream, který představuje obsah archivu.
Příklady
Použití:
Stream decompressed = archive.Open();
.NET 4.0 a vyšší - použijte metodu Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 a předtím - kopírujte bajty ručně:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Poznámky
Čtěte ze streamu, abyste získali původní obsah souboru. Viz sekce příkladů.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Uloží archiv do poskytnutého streamu.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Parametry
outputStream
Stream
Cílový stream.
saveOptions
UueSaveOptions
Možnosti pro ukládání archivu.
Příklady
Píše komprimovaná data do streamu http odpovědi.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Poznámky
outputStream
musí být zapisovatelný.
Výjimky
Zdroj dat, který má být archivován, nebyl poskytnut.
outputStream
není zapisovatelný.
Zdroj souboru je pouze pro čtení nebo je adresář.
Určená cesta ke zdroji souboru je neplatná, například je na nepřiřazeném disku.
Zdroj souboru je již otevřen.
Save(string, UueSaveOptions)
Uloží archiv do poskytnutého cílového souboru.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Parametry
destinationFileName
string
Cesta archivu, který má být vytvořen. Pokud určený název souboru ukazuje na existující soubor, bude přepsán.
saveOptions
UueSaveOptions
Možnosti pro ukládání archivu.
Příklady
Píše kódovaná data do souboru.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Výjimky
destinationFileName
je null.
Volající nemá požadované oprávnění pro přístup.
destinationFileName
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru destinationFileName
je odepřen.
Určená destinationFileName
, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na destinationFileName
obsahuje dvojtečku (:) uprostřed řetězce.
SetSource(Stream)
Nastaví obsah, který má být kódován v archivu.
public void SetSource(Stream source)
Parametry
source
Stream
Vstupní stream pro archiv.
Příklady
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Nastaví obsah, který má být komprimován v archivu.
public void SetSource(FileInfo fileInfo)
Parametry
fileInfo
FileInfo
Reference na soubor, který má být komprimován.
Příklady
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Nastaví obsah, který má být kódován v archivu.
public void SetSource(string path)
Parametry
path
string
Cesta k souboru, který má být kódován.
Příklady
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Výjimky
path
je null.
Volající nemá požadované oprávnění pro přístup.
path
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru path
je odepřen.
Určená path
, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách založených na Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.