Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
Cette classe représente un fichier uuencodé.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntryHéritage
Implémente
IArchive, IDisposable, IArchiveFileEntry
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructeurs
UueArchive()
Initialise une nouvelle instance de la classe Aspose.Zip.Uue.UueArchive préparée pour l’encodage.
public UueArchive()Exemples
L'exemple suivant montre comment uuencoder un fichier.
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}UueArchive(Stream)
Initialise une nouvelle instance de la classe Aspose.Zip.Uue.UueArchive préparée pour le décodage.
public UueArchive(Stream sourceStream)Paramètres
sourceStream Stream
La source de l’archive.
Exemples
Ouvre une archive à partir d'un flux et l'extrait dans un MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
archive.Open().CopyTo(ms);Remarques
Ce constructeur ne décode pas. Voir la méthode Aspose.Zip.Uue.UueArchive.Open pour décompresser.
UueArchive(string)
Initialise une nouvelle instance de la classe Aspose.Zip.Uue.UueArchive.
public UueArchive(string path)Paramètres
path string
Le chemin vers le fichier d’archive.
Exemples
Ouvre une archive à partir d'un fichier par chemin et la décode dans un MemoryStream
var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
archive.Open().CopyTo(ms);Remarques
Ce constructeur ne décompresse pas. Voir la méthode Aspose.Zip.Uue.UueArchive.Open pour décompresser.
Exceptions
path est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path est vide, ne contient que des espaces blancs, ou contient des caractères invalides.
L’accès au fichier path est refusé.
Le path, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path contient deux-points (:) au milieu de la chaîne.
Propriétés
Name
Nom du fichier d’origine.
public string Name { get; }Valeur de propriété
Méthodes
Dispose()
Effectue des tâches définies par l’application associées à la libération, à la remise ou à la réinitialisation des ressources non gérées.
public void Dispose()Dispose(bool)
Effectue des tâches définies par l’application associées à la libération, à la remise ou à la réinitialisation des ressources non gérées.
protected virtual void Dispose(bool disposing)Paramètres
disposing bool
Indique si les ressources gérées doivent être libérées.
Extract(Stream)
Extrait l’archive vers le flux fourni.
public void Extract(Stream destination)Paramètres
destination Stream
Flux de destination. Doit être écrivable.
Exemples
using (var archive = new UueArchive("archive.uue"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination ne prend pas en charge l’écriture.
Extract(string)
Extrait l’archive vers le fichier par chemin.
public FileInfo Extract(string path)Paramètres
path string
Le chemin vers le fichier de destination. Si le fichier existe déjà, il sera écrasé.
Retourne
Info du fichier extrait.
Exceptions
path est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path est vide, ne contient que des espaces blancs, ou contient des caractères invalides.
L’accès au fichier path est refusé.
Le path, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path contient un deux-points (:) au milieu de la chaîne.
Le fichier est introuvable.
Le chemin spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
Le fichier est déjà ouvert.
ExtractToDirectory(string)
Extrait le contenu de l’archive vers le répertoire fourni.
public void ExtractToDirectory(string destinationDirectory)Paramètres
destinationDirectory string
Le chemin vers le répertoire où placer les fichiers extraits.
Remarques
Si le répertoire n’existe pas, il sera créé.
Exceptions
destinationDirectory est nul.
Le chemin spécifié, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères et les noms de fichiers doivent être inférieurs à 260 caractères.
L’appelant n’a pas la permission requise pour accéder au répertoire existant.
Si le répertoire n’existe pas, le chemin contient un caractère deux-points (:) qui ne fait pas partie d’une étiquette de lecteur (“C:").
destinationDirectory est une chaîne de longueur nulle, ne contient que des espaces blancs, ou contient un ou plusieurs caractères invalides. Vous pouvez interroger les caractères invalides en utilisant la méthode System.IO.Path.GetInvalidPathChars.
-ou- le chemin est préfixé par, ou ne contient que, un caractère deux-points (:).
Le répertoire spécifié par le chemin est un fichier. -ou- Le nom du réseau n’est pas connu.
Open()
Ouvre l’archive pour le décodage et fournit un flux avec le contenu de l’archive.
public Stream Open()Retourne
Le flux qui représente le contenu de l’archive.
Exemples
Utilisation :
Stream decompressed = archive.Open();
.NET 4.0 et supérieur - utilisez la méthode Stream.CopyTo :
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 et avant - copiez les octets manuellement :
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Remarques
Lisez à partir du flux pour obtenir le contenu original du fichier. Voir la section des exemples.
### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)
Enregistre l'archive dans le flux fourni.
```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)Paramètres
outputStream Stream
Flux de destination.
saveOptions UueSaveOptions
Options pour l’enregistrement de l’archive.
Exemples
Écrit des données compressées dans le flux de réponse http.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarques
outputStream doit être écrivable.
Exceptions
La source des données à archiver n’a pas été fournie.
outputStream n’est pas écrivable.
La source de fichier est en lecture seule ou est un répertoire.
Le chemin de source de fichier spécifié est invalide, par exemple s’il se trouve sur un lecteur non mappé.
La source de fichier est déjà ouverte.
Save(string, UueSaveOptions)
Enregistre l’archive dans le fichier de destination fourni.
public void Save(string destinationFileName, UueSaveOptions saveOptions = null)Paramètres
destinationFileName string
Le chemin de l’archive à créer. Si le nom de fichier spécifié pointe vers un fichier existant, il sera écrasé.
saveOptions UueSaveOptions
Options pour l’enregistrement de l’archive.
Exemples
Écrit des données encodées dans un fichier.
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.uue");
}Exceptions
destinationFileName est nul.
L’appelant n’a pas la permission requise pour accéder.
Le destinationFileName est vide, ne contient que des espaces blancs, ou contient des caractères invalides.
L’accès au fichier destinationFileName est refusé.
Le destinationFileName, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à destinationFileName contient un deux-points (:) au milieu de la chaîne.
SetSource(Stream)
Définit le contenu à encoder dans l’archive.
public void SetSource(Stream source)Paramètres
source Stream
Le flux d’entrée pour l’archive.
Exemples
using (var archive = new UueArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.uue");
}SetSource(FileInfo)
Définit le contenu à compresser dans l’archive.
public void SetSource(FileInfo fileInfo)Paramètres
fileInfo FileInfo
La référence à un fichier à compresser.
Exemples
using (var archive = new UueArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.uue");
}SetSource(string)
Définit le contenu à encoder dans l’archive.
public void SetSource(string path)Paramètres
path string
Chemin vers le fichier à encoder.
Exemples
using (var archive = new UueArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.uue");
}Exceptions
path est nul.
L’appelant n’a pas la permission requise pour accéder.
Le path est vide, ne contient que des espaces blancs, ou contient des caractères invalides.
L’accès au fichier path est refusé.
Le path, le nom de fichier, ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le fichier à path contient un deux-points (:) au milieu de la chaîne.
