Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse repräsentiert eine uu-codierte Datei.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Vererbung
Implementiert
IArchive, IDisposable, IArchiveFileEntry
Vererbte Mitglieder
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktoren
UueArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Uue.UueArchive-Klasse, die für die Kodierung vorbereitet ist.
public UueArchive()
Beispiele
Das folgende Beispiel zeigt, wie man eine Datei uu-codiert.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Uue.UueArchive-Klasse, die für das Dekodieren vorbereitet ist.
public UueArchive(Stream sourceStream)
Parameter
sourceStream
Stream
Die Quelle des Archivs.
Beispiele
Öffnen Sie ein Archiv aus einem Stream und extrahieren Sie es in einen MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Bemerkungen
Dieser Konstruktor dekodiert nicht. Siehe die Aspose.Zip.Uue.UueArchive.Open-Methode zum Dekomprimieren.
UueArchive(string)
Initialisiert eine neue Instanz der Aspose.Zip.Uue.UueArchive-Klasse.
public UueArchive(string path)
Parameter
path
string
Der Pfad zur Archivdatei.
Beispiele
Öffnen Sie ein Archiv aus einer Datei über den Pfad und dekodieren Sie es in einen MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Bemerkungen
Dieser Konstruktor dekomprimiert nicht. Siehe die Aspose.Zip.Uue.UueArchive.Open-Methode zum Dekomprimieren.
Ausnahmen
path
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path
ist verweigert.
Der angegebene path
, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen unter Windows-basierten Plattformen die Pfade weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen lang sein.
Die Datei am path
enthält einen Doppelpunkt (:) in der Mitte des Strings.
Eigenschaften
Name
Name der Originaldatei.
public string Name { get; }
Eigenschaftswert
Methoden
Dispose()
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
public void Dispose()
Dispose(bool)
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)
Parameter
disposing
bool
Ob verwaltete Ressourcen freigegeben werden sollen.
Extract(Stream)
Extrahiert das Archiv in den bereitgestellten Stream.
public void Extract(Stream destination)
Parameter
destination
Stream
Zielstream. Muss beschreibbar sein.
Beispiele
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Ausnahmen
destination
unterstützt kein Schreiben.
Extract(string)
Extrahiert das Archiv in die Datei über den Pfad.
public FileInfo Extract(string path)
Parameter
path
string
Der Pfad zur Zieldatei. Wenn die Datei bereits existiert, wird sie überschrieben.
Rückgabewert
Informationen zur extrahierten Datei.
Ausnahmen
path
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path
ist verweigert.
Der angegebene path
, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen unter Windows-basierten Plattformen die Pfade weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen lang sein.
Die Datei am path
enthält einen Doppelpunkt (:) in der Mitte des Strings.
Die Datei wurde nicht gefunden.
Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
ExtractToDirectory(string)
Extrahiert den Inhalt des Archivs in das bereitgestellte Verzeichnis.
public void ExtractToDirectory(string destinationDirectory)
Parameter
destinationDirectory
string
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien abgelegt werden sollen.
Bemerkungen
Wenn das Verzeichnis nicht existiert, wird es erstellt.
Ausnahmen
destinationDirectory
ist null.
Der angegebene Pfad, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen unter Windows-basierten Plattformen die Pfade weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen lang sein.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf das vorhandene Verzeichnis.
Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:), das nicht Teil eines Laufwerksbezeichners (“C:") ist.
destinationDirectory
ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können ungültige Zeichen mit der Methode System.IO.Path.GetInvalidPathChars abfragen.
-oder- der Pfad wird mit oder enthält nur ein Doppelpunktzeichen (:) vorangestellt.
Das durch den Pfad angegebene Verzeichnis ist eine Datei. -oder- Der Netzwerkname ist unbekannt.
Open()
Öffnet das Archiv zum Dekodieren und stellt einen Stream mit dem Archivinhalt bereit.
public Stream Open()
Rückgabewert
Der Stream, der den Inhalt des Archivs darstellt.
Beispiele
Verwendung:
Stream decompressed = archive.Open();
.NET 4.0 und höher - verwenden Sie die Stream.CopyTo-Methode:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 und früher - Bytes manuell kopieren:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Bemerkungen
Lesen Sie aus dem Stream, um den ursprünglichen Inhalt der Datei zu erhalten. Siehe Abschnitt Beispiele.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Speichert das Archiv im bereitgestellten Stream.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Parameter
outputStream
Stream
Zielstream.
saveOptions
UueSaveOptions
Optionen für das Speichern des Archivs.
Beispiele
Schreibt komprimierte Daten in den HTTP-Antwortstream.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Bemerkungen
outputStream
muss beschreibbar sein.
Ausnahmen
Die Quelle der zu archivierenden Daten wurde nicht bereitgestellt.
outputStream
ist nicht beschreibbar.
Die Quelldatei ist schreibgeschützt oder ist ein Verzeichnis.
Der angegebene Dateiquellenpfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Quelldatei ist bereits geöffnet.
Save(string, UueSaveOptions)
Speichert das Archiv in der bereitgestellten Zieldatei.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Parameter
destinationFileName
string
Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei zeigt, wird sie überschrieben.
saveOptions
UueSaveOptions
Optionen für das Speichern des Archivs.
Beispiele
Schreibt kodierte Daten in eine Datei.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Ausnahmen
destinationFileName
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der destinationFileName
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei destinationFileName
ist verweigert.
Der angegebene destinationFileName
, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen unter Windows-basierten Plattformen die Pfade weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen lang sein.
Die Datei am destinationFileName
enthält einen Doppelpunkt (:) in der Mitte des Strings.
SetSource(Stream)
Setzt den Inhalt, der im Archiv kodiert werden soll.
public void SetSource(Stream source)
Parameter
source
Stream
Der Eingabestream für das Archiv.
Beispiele
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Setzt den Inhalt, der im Archiv komprimiert werden soll.
public void SetSource(FileInfo fileInfo)
Parameter
fileInfo
FileInfo
Die Referenz auf eine Datei, die komprimiert werden soll.
Beispiele
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Setzt den Inhalt, der im Archiv kodiert werden soll.
public void SetSource(string path)
Parameter
path
string
Pfad zur Datei, die kodiert werden soll.
Beispiele
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Ausnahmen
path
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path
ist verweigert.
Der angegebene path
, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen unter Windows-basierten Plattformen die Pfade weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen lang sein.
Die Datei am path
enthält einen Doppelpunkt (:) in der Mitte des Strings.