API pour manipuler les fichiers Publisher en C#

Aspose.PUB pour .NET vous permet de travailler avec des fichiers PUB dans vos applications .NET. Il prend en charge la manipulation des fichiers .pub avec une structure simple et bien définie. 

Modifier les métadonnées des fichiers PUB

Métadonnées des fichiers .pub accessibles par Aspose.PUB

Les fichiers Microsoft Publisher (.pub) contiennent des informations de métadonnées sur le fichier lui-même. Il existe des exemples d’informations que vous pouvez obtenir en utilisant cette solution API :

Métadonnées	Description
Nom de l’application	Le nom de l’application qui a été utilisée pour créer le document
Titre	Le titre de la publication.
Auteur	Le nom de la personne ou de l’entité qui a créé la publication.
Version	Valeur de la version
Sujet	Une brève description ou un sujet associé à la publication.
Mots-clés	Mots-clés ou balises pertinents pour décrire le contenu de la publication.
Commentaires	Notes supplémentaires liées à la publication.
Date de création	La date à laquelle la publication a été créée à l’origine.
Date de modification	La date à laquelle la publication a été modifiée pour la dernière fois.
Dernier auteur	Le nom de la personne qui a apporté les dernières modifications au document.
Modèle	Modèle spécifique à l’application à partir duquel le document a été créé.
Nombre de caractères	Fournit le nombre total de caractères dans le document.
Nombre de mots	Fournit le nombre total de mots dans le document.
Nombre de pages	Fournit le nombre total de pages dans le document.

Fonctionnalité permettant de travailler avec les métadonnées des fichiers .pub fournies par Aspose.PUB pour .NET

Les métadonnées décrivent les propriétés du document, notamment le titre, la société, la langue et les informations associées. L’exemple suivant analyse halloween-flyer.pub et met à jour huit propriétés au moyen des classes DocSummaryInfo et SummaryInfo. Ces modifications affectent le Document analysé en mémoire ; l’exemple n’enregistre pas de fichier PUB modifié.

Dans ces exemples, DataDir désigne le répertoire d’entrée et OutputDir le répertoire de sortie. Définissez vos propres répertoires et assurez-vous que le répertoire de sortie existe avant d’exécuter l’exemple utilisant un flux. Importez les espaces de noms Aspose.Pub et System.IO lorsque vous utilisez les extraits dans votre application.

// Edit the metadata of a parsed PUB document in memory

// Parse the input Publisher document.
string fileName = Path.Combine(DataDir, "halloween-flyer.pub");
IPubParser parser = PubFactory.CreateParser(fileName);
Document document = parser.Parse();

// Update document metadata. These changes do not save a PUB file.
document.DocumentSummaryInfo.SetCategory("category");
document.DocumentSummaryInfo.SetCompany("company");
document.DocumentSummaryInfo.SetLanguage("language");

document.SummaryInfo.SetComments("comments");
document.SummaryInfo.SetKeywords("keywords");
document.SummaryInfo.SetLastAuthor("last author");
document.SummaryInfo.SetTitle("title");
document.SummaryInfo.SetSubject("subject");

Écrire la sortie dans le flux

L’exemple suivant convertit un document PUB en TIFF et écrit le résultat dans un flux de fichier. Le bloc using ferme le flux après la conversion. Voici comment fonctionne l’exemple :

1. Construisez le chemin d’entrée avec Path.Combine(DataDir, "halloween-flyer.pub").
2. Créez un IPubParser à l’aide de PubFactory.CreateParser(fileName), puis appelez parser.Parse() pour obtenir un objet Document.
3. Construisez outPath avec Path.Combine(OutputDir, "halloween-flyer_out.tiff") et ouvrez le flux de sortie avec File.Create(outPath). Cela crée le fichier ou tronque un fichier existant.
4. Appelez PubFactory.CreatePubConverter() pour créer un convertisseur, puis appelez ConvertToFormat(doc, outputStream, PubExportFormats.Tiff) pour écrire les données TIFF dans le flux. Le flux est libéré à la fin du bloc using.

De la même manière, vous pouvez convertir PUB dans un autre format, en utilisant l’un des PubExportFormats pris en charge.

// Convert a PUB document to TIFF using an output stream

// Parse the input Publisher document.
string fileName = Path.Combine(DataDir, "halloween-flyer.pub");
IPubParser parser = PubFactory.CreateParser(fileName);
Document doc = parser.Parse();

// Write TIFF output to a file stream and close it after conversion.
string outPath = Path.Combine(OutputDir, "halloween-flyer_out.tiff");
using (FileStream outputStream = File.Create(outPath))
{
    PubFactory.CreatePubConverter().ConvertToFormat(doc, outputStream, PubExportFormats.Tiff);
}

Pour connaître tous les exemples de code .NET et les fichiers de données, veuillez accéder à Aspose.PUB-Documentation for C# Github project.

Jetez également un œil aux fonctionnalités fournies par Aspose.PUB implémentées dans un ensemble d’ applications multiplateformes pour manipuler les fichiers .pub.