Class PdfManager

Information

Représente le composant Documentize.PdfManager. Utilisé pour fusionner, scinder, optimiser, pivoter, redimensionner, compresser des documents PDF et ajouter un tableau, ajouter une table des matières aux documents PDF. Peut fusionner plusieurs documents PDF en un seul PDF. Peut scinder des documents PDF en pages séparées. Peut optimiser, pivoter, redimensionner, compresser des documents PDF. Peut pivoter, redimensionner les pages d’un document PDF. Peut ajouter un tableau à un document PDF. Peut ajouter une table des matières à un document PDF.

Représente le composant Documentize.PdfManager. Utilisé pour fusionner, scinder, optimiser, pivoter, redimensionner, compresser des documents PDF et ajouter un tableau, ajouter une table des matières aux documents PDF.
Peut fusionner plusieurs documents PDF en un seul PDF.
Peut scinder des documents PDF en pages séparées.
Peut optimiser, pivoter, redimensionner, compresser des documents PDF.
Peut pivoter, redimensionner les pages d’un document PDF.
Peut ajouter un tableau à un document PDF.
Peut ajouter une table des matières à un document PDF.

public static class PdfManager

Héritage

object ← PdfManager

Membres hérités

Méthodes

AddTable(TableOptions)

Ajouter un tableau à un document PDF.

public static ResultContainer AddTable(TableOptions options)

Paramètres

options TableOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment ajouter un tableau à un fichier PDF.

// Configurer les options du tableau
var options = new TableOptions();
options.InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Name")
            .AddCell().AddParagraph("Age")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_input.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_output.pdf"));
// Exécuter le processus
PdfManager.AddTable(options);

L’exemple montre comment ajouter un tableau à un fichier PDF avant la page 2.

// Configurer les options du tableau
var options = new TableOptions();
options.InsertPageBefore(2) // Ajouter le tableau avant la page 2
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Name")
            .AddCell().AddParagraph("Age");
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_input.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_output.pdf"));
// Exécuter le processus
PdfManager.AddTable(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

AddTableOfContents(TocOptions)

Ajouter une table des matières (TOC) à un document PDF.

public static ResultContainer AddTableOfContents(TocOptions options)

Paramètres

options TocOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment ajouter une table des matières à un fichier PDF.

// Créer l'objet TocOptions pour définir les instructions
var options = new TocOptions();
// Définir le titre
options.Title = "My Table of Contents";
// Concevoir les titres
options.Headings.Add(new TocHeading("Introduction", 2));
options.Headings.Add(new TocHeading("Chapter I", 3));
options.Headings.Add(new TocHeading("Chapter II", 4));
options.Headings.Add(new TocHeading("Chapter III", 5));
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.AddTableOfContents(options);

L’exemple montre comment ajouter une table des matières à un fichier PDF avec génération de signets.

// Créer l'objet TocOptions pour définir les instructions
var options = new TocOptions();
// Définir le titre
options.Title = "My Table of Contents";
// Générer les liens dans les signets
options.GenerateBookmarks = true;
// Concevoir les titres
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
options.Headings.Add(new TocHeading("Chapter I", 3, true, 1));
options.Headings.Add(new TocHeading("Chapter II", 4, true, 1));
options.Headings.Add(new TocHeading("Example A", 4, true, 2));
options.Headings.Add(new TocHeading("Example B", 4, true, 2));
options.Headings.Add(new TocHeading("Example C", 4, true, 2));
options.Headings.Add(new TocHeading("Example D", 4, true, 2));
options.Headings.Add(new TocHeading("Chapter III", 5, true, 1));
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
 // Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.AddTableOfContents(options);

L’exemple montre comment ajouter une table des matières à un fichier PDF et l’enregistrer sous forme de flux.

// Créer l'objet TocOptions pour définir les instructions
var options = new TocOptions();
// Définir le titre
options.Title = "My Table of Contents";
// Concevoir les titres
options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le flux de sortie 
var outputStream = new MemoryStream();
options.AddOutput(new StreamData(outputStream));
options.CloseOutputStreams = false;
// Exécuter le processus
PdfManager.AddTableOfContents(options);

L’exemple montre comment ajouter une table des matières à un fichier PDF avec personnalisation du titre du TOC.

// Créer l'objet TocOptions pour définir les instructions
var heading = new TocHeading();
heading.Text = "Intro";
heading.PageNumber = 5;
heading.GenerateNumbering = true;
heading.Level = 2;
var tocOptions = new TocOptions();
tocOptions.Headings.Add(heading);
// Ajouter les fichiers d'entrée et de sortie
tocOptions.AddInput(new FileData("path_to_your_pdf_file.pdf"));
tocOptions.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Générer le TOC avec les options personnalisées
PdfManager.AddTableOfContents(tocOptions);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Compress(CompressOptions)

Compresser un document PDF. Tente de réduire la taille du document.

public static ResultContainer Compress(CompressOptions options)

Paramètres

options CompressOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment compresser un document PDF.

// Créer l'objet CompressOptions pour définir les instructions
var options = new CompressOptions();
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.Compress(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

CreatePdfByChatGptRequestAsync(ChatGptRequestOptions)

Créer un document PDF à partir de la réponse de ChatGpt.
Utilisé pour envoyer des requêtes directement à ChatGPT ou en ajoutant des sources de fichiers PDF et enregistrer la réponse dans la source de sortie.

public static Task<ResultContainer> CreatePdfByChatGptRequestAsync(ChatGptRequestOptions options)

Paramètres

options ChatGptRequestOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

Task<ResultContainer>
Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment utiliser ChatGpt en ajoutant des messages à la requête.

var options = new ChatGptRequestOptions();
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf")); 
options.ApiKey = "Your API key."; // Vous devez fournir la clé pour accéder à l'API.
options.MaxTokens = 1000; // Nombre maximal de tokens à générer dans la complétion.

// Ajouter les messages de la requête.
options.Messages.Add(new Message
{
    Content = "You are a helpful assistant.",
    Role = Role.System
});
options.Messages.Add(new Message
{
    Content = "What is the biggest pizza diameter ever made?",
    Role = Role.User
});

// Exécuter la requête.
var result = await PdfManager.CreatePdfByChatGptRequestAsync(options);

var fileResultPath = result.ResultCollection[0].Data;
var chatCompletionObject = result.ResultCollection[1].Data as ChatCompletion; // L'objet de complétion de chat de l'API ChatGPT.

L’exemple montre comment utiliser ChatGpt en ajoutant un seul message à la requête.

var options = new ChatGptRequestOptions();
options.AddOutput(new FileData("path_to_result_pdf_file.pdf")); // Ajouter le chemin du fichier de sortie.
options.ApiKey = "Your API key."; // Vous devez fournir la clé pour accéder à l'API.
options.MaxTokens = 1000; // Nombre maximal de tokens à générer dans la complétion.

// Ajouter le message de la requête.
// Dans ce cas, le message système avec Content = "You are a helpful assistant." est ajouté par défaut.
// Le rôle du message de requête est "user" par défaut.
options.Query = "What is the lowest temperature recorded on the Earth?";

// Exécuter la requête.
var result = await PdfManager.CreatePdfByChatGptRequestAsync(options);

var fileResultPath = result.ResultCollection[0].Data;
var chatCompletionObject = result.ResultCollection[1].Data as ChatCompletion; // L'objet de complétion de chat de l'API ChatGPT.

L’exemple montre comment utiliser le chat en ajoutant des fichier(s) comme source(s) de message.

var options = new ChatGptRequestOptions();
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));

// Ajouter la source texte du PDF.
// En cas de sources multiples, le texte de chaque document sera ajouté à la collection de messages de requête
// comme un message distinct avec le rôle "user".
options.AddInput(new FileData("TextSource.pdf"));

options.ApiKey = "Your API key."; // Vous devez fournir la clé pour accéder à l'API.
options.MaxTokens = 1000; // Nombre maximal de tokens à générer dans la complétion.

// Ajouter le message de la requête.
// Dans ce cas, le message système avec Content = "You are a helpful assistant." est ajouté par défaut.
// Le rôle du message de requête est "user" par défaut.
options.Query = "How many letters in the provided text?";

// Exécuter la requête.
var result = await PdfManager.CreatePdfByChatGptRequestAsync(options);

var fileResultPath = result.ResultCollection[0].Data;
var chatCompletionObject = result.ResultCollection[1].Data as ChatCompletion; // L'objet de complétion de chat de l'API ChatGPT.

Exceptions

ArgumentException : Si les options ne sont pas définies.

Merge(MergeOptions)

Fusionner des documents PDF.

public static ResultContainer Merge(MergeOptions options)

Paramètres

options MergeOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment fusionner deux documents PDF.

// Créer l'objet MergeOptions pour définir les instructions
var options = new MergeOptions();
// Ajouter les chemins des fichiers d'entrée
options.AddInput(new FileData("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileData("path_to_your_pdf_file_2.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.Merge(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Optimize(OptimizeOptions)

Optimiser un document PDF.
Lineariser le document afin de :

ouvrir la première page le plus rapidement possible ;
afficher la page suivante ou suivre le lien vers la page suivante le plus rapidement possible ;
afficher la page de façon incrémentielle dès que les données arrivent sur un canal lent (afficher d’abord les données les plus utiles) ;
permettre des interactions utilisateur, comme suivre un lien, avant que la page entière ne soit reçue et affichée.

public static ResultContainer Optimize(OptimizeOptions options)

Paramètres

options OptimizeOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment optimiser un document PDF.

// Créer l'objet OptimizeOptions pour définir les instructions
var options = new OptimizeOptions();
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.Optimize(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Resize(ResizeOptions)

Redimensionner les pages d’un document PDF.

public static ResultContainer Resize(ResizeOptions options)

Paramètres

options ResizeOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment redimensionner un document PDF.

// Créer l'objet ResizeOptions pour définir les instructions
var options = new ResizeOptions();
// Définir la nouvelle taille de page
options.PageSize = PageSize.A3;
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.Resize(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Rotate(RotateOptions)

Pivoter les pages d’un document PDF.

public static ResultContainer Rotate(RotateOptions options)

Paramètres

options RotateOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment pivoter un document PDF.

// Créer l'objet RotateOptions pour définir les instructions
var options = new RotateOptions();
// Définir la nouvelle rotation
options.Rotation = Rotation.On90;
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir le chemin du fichier de sortie
options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
// Exécuter le processus
PdfManager.Rotate(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Split(SplitOptions)

Scinder un document PDF par pages.

public static ResultContainer Split(SplitOptions options)

Paramètres

options SplitOptions : Un objet d’options contenant les instructions pour l’opération.

Retourne

ResultContainer : Un objet contenant le résultat de l’opération.

Exemples

L’exemple montre comment scinder un document PDF.

// Créer l'objet SplitOptions pour définir les instructions
var options = new SplitOptions();
// Ajouter le chemin du fichier d'entrée
options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
// Définir les chemins des fichiers de sortie
options.AddOutput(new FileData("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileData("path_to_result_pdf_file_2.pdf"));
// Exécuter le processus
PdfManager.Split(options);

Exceptions

ArgumentException
Si les options ne sont pas définies.

Namespace: Documentize
Assembly: Documentize.dll