Class UueArchive

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

objectUueArchive

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

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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.

NotSupportedException

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

string

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

ArgumentException

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

FileInfo

Informacje o wyodrębnionym pliku.

Wyjątki

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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.

NotSupportedException

Plik w path zawiera dwukropek (:) w środku ciągu.

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.

IOException

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

ArgumentNullException

destinationDirectory jest null.

PathTooLongException

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.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.

NotSupportedException

Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) który nie jest częścią etykiety dysku (“C:").

ArgumentException

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 (:).

IOException

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

Stream

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

InvalidOperationException

Źródło danych do archiwizacji nie zostało podane.

ArgumentException

outputStream nie jest zapisywalny.

UnauthorizedAccessException

Źródło pliku jest tylko do odczytu lub jest katalogiem.

DirectoryNotFoundException

Określona ścieżka źródła pliku jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.

IOException

Ź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

ArgumentNullException

destinationFileName jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

destinationFileName jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku destinationFileName jest zabroniony.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

path jest null.

SecurityException

Wywołujący nie ma wymaganych uprawnień do dostępu.

ArgumentException

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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.

NotSupportedException

Plik w path zawiera dwukropek (:) w środku ciągu.

 Polski