Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Ta klasa reprezentuje plik zakodowany w formacie uuencoded.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
Dziedziczenie
Implementuje
IArchive, IDisposable, IArchiveFileEntry
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktorzy
UueArchive()
Inicjalizuje nową instancję klasy Aspose.Zip.Uue.UueArchive przygotowaną do kodowania.
public UueArchive()
Przykłady
Poniższy przykład pokazuje, jak zakodować plik w formacie uuencode.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
UueArchive(Stream)
Inicjalizuje nową instancję klasy Aspose.Zip.Uue.UueArchive przygotowaną do dekodowania.
public UueArchive(Stream sourceStream)
Parametry
sourceStream
Stream
Źródło archiwum.
Przykłady
Otwórz archiwum z strumienia i wyodrębnij je do MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);
Uwagi
Ten konstruktor nie dekoduje. Zobacz metodę Aspose.Zip.Uue.UueArchive.Open, aby rozpakować.
UueArchive(string)
Inicjalizuje nową instancję klasy Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)
Parametry
path
string
Ścieżka do pliku archiwum.
Przykłady
Otwórz archiwum z pliku według ścieżki i dekoduj je do MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);
Uwagi
Ten konstruktor nie rozpakowuje. Zobacz metodę Aspose.Zip.Uue.UueArchive.Open, aby rozpakować.
Wyjątki
path
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku path
jest zabroniony.
Określona path
, nazwa pliku lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.
Plik w path
zawiera dwukropek (:) w środku ciągu.
Właściwości
Name
Nazwa oryginalnego pliku.
public string Name { get; }
Wartość właściwości
Metody
Dispose()
Wykonuje zadania zdefiniowane przez aplikację związane z zwalnianiem, uwalnianiem lub resetowaniem zasobów niezarządzanych.
public void Dispose()
Dispose(bool)
Wykonuje zadania zdefiniowane przez aplikację związane z zwalnianiem, uwalnianiem lub resetowaniem zasobów niezarządzanych.
protected virtual void Dispose(bool disposing)
Parametry
disposing
bool
Czy zasoby zarządzane powinny być zwalniane.
Extract(Stream)
Wyodrębnia archiwum do podanego strumienia.
public void Extract(Stream destination)
Parametry
destination
Stream
Strumień docelowy. Musi być zapisywalny.
Przykłady
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}
Wyjątki
destination
nie obsługuje zapisu.
Extract(string)
Wyodrębnia archiwum do pliku według ścieżki.
public FileInfo Extract(string path)
Parametry
path
string
Ścieżka do pliku docelowego. Jeśli plik już istnieje, zostanie nadpisany.
Zwraca
Informacje o wyodrębnionym pliku.
Wyjątki
path
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku path
jest zabroniony.
Określona path
, nazwa pliku, lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.
Plik w path
zawiera dwukropek (:) w środku ciągu.
Plik nie został znaleziony.
Określona ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
Plik jest już otwarty.
ExtractToDirectory(string)
Wyodrębnia zawartość archiwum do podanego katalogu.
public void ExtractToDirectory(string destinationDirectory)
Parametry
destinationDirectory
string
Ścieżka do katalogu, do którego mają być umieszczone wyodrębnione pliki.
Uwagi
Jeśli katalog nie istnieje, zostanie utworzony.
Wyjątki
destinationDirectory
jest null.
Określona ścieżka, nazwa pliku, lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.
Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.
Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) który nie jest częścią etykiety dysku (“C:").
destinationDirectory
jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz zapytać o nieprawidłowe znaki, używając metody System.IO.Path.GetInvalidPathChars.
-lub- ścieżka jest poprzedzona, lub zawiera, tylko znak dwukropka (:).
Katalog określony przez ścieżkę jest plikiem. -lub- Nazwa sieci nie jest znana.
Open()
Otwiera archiwum do dekodowania i udostępnia strumień z zawartością archiwum.
public Stream Open()
Zwraca
Strumień, który reprezentuje zawartość archiwum.
Przykłady
Użycie:
Stream decompressed = archive.Open();
.NET 4.0 i wyższe - użyj metody Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 i wcześniejsze - kopiuj bajty ręcznie:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Uwagi
Odczytaj ze strumienia, aby uzyskać oryginalną zawartość pliku. Zobacz sekcję przykładów.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Zapisuje archiwum do podanego strumienia.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)
Parametry
outputStream
Stream
Strumień docelowy.
saveOptions
UueSaveOptions
Opcje dotyczące zapisywania archiwum.
Przykłady
Zapisuje skompresowane dane do strumienia odpowiedzi http.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Uwagi
outputStream
musi być zapisywalny.
Wyjątki
Źródło danych do archiwizacji nie zostało podane.
outputStream
nie jest zapisywalny.
Źródło pliku jest tylko do odczytu lub jest katalogiem.
Określona ścieżka źródła pliku jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
Źródło pliku jest już otwarte.
Save(string, UueSaveOptions)
Zapisuje archiwum do podanego pliku docelowego.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)
Parametry
destinationFileName
string
Ścieżka archiwum do utworzenia. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.
saveOptions
UueSaveOptions
Opcje dotyczące zapisywania archiwum.
Przykłady
Zapisuje zakodowane dane do pliku.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}
Wyjątki
destinationFileName
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
destinationFileName
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku destinationFileName
jest zabroniony.
Określona destinationFileName
, nazwa pliku, lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.
Plik w destinationFileName
zawiera dwukropek (:) w środku ciągu.
SetSource(Stream)
Ustawia zawartość, która ma być kodowana w archiwum.
public void SetSource(Stream source)
Parametry
source
Stream
Strumień wejściowy dla archiwum.
Przykłady
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}
SetSource(FileInfo)
Ustawia zawartość, która ma być skompresowana w archiwum.
public void SetSource(FileInfo fileInfo)
Parametry
fileInfo
FileInfo
Odwołanie do pliku, który ma być skompresowany.
Przykłady
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}
SetSource(string)
Ustawia zawartość, która ma być kodowana w archiwum.
public void SetSource(string path)
Parametry
path
string
Ścieżka do pliku, który ma być zakodowany.
Przykłady
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}
Wyjątki
path
jest null.
Wywołujący nie ma wymaganych uprawnień do dostępu.
path
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku path
jest zabroniony.
Określona path
, nazwa pliku, lub oba przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.
Plik w path
zawiera dwukropek (:) w środku ciągu.