Utilisation d'IronPPT avec les assistants de codage AI

Curtis Chau
Curtis Chau
Mis à jour : 19 octobre 2026

IronPPT est la bibliothèque PowerPoint pour .NET d'Iron Software. Elle crée, ouvre et édite des présentations PPTX à partir de code C# sans Microsoft Office ni Interop, et un seul package couvre chaque plateforme exécutant .NET Standard 2.0.

Une présentation trimestrielle, un ensemble de documents de cours ou une liste de propriétés dépendent tous des mêmes quelques opérations, qui sont l'ajout de diapositives, l'ajout de texte et d'images sur celles-ci, puis le changement d'ordre avant l'envoi du fichier. Un assistant sans la documentation d'IronPPT n'a pas de liste des membres existants, et l'un des exemples de guide d'IronPPT compile et s'exécute mais laisse le diaporama sauvegardé inchangé.

Le processus d'installation est le même pour chaque assistant. Ajoutez le package, assignez la clé depuis l'environnement, fournissez à l'assistant la documentation lisible à la machine d'IronPPT, et relisez chaque diaporama sauvegardé avant de marquer la tâche comme terminée. Cela s'applique à l'ajout de diapositives, l'ajout de texte, la gestion des images, et la gestion des diapositives.

Logo de l'assistant de codage Claude Code AILogo de l'assistant de codage ChatGPT Codex AILogo de l'assistant de codage AI GitHub CopilotLogo de l'éditeur de code AI CursorLogo de l'agent de codage AI Google Antigravity

Mon assistant AI ne peut-il pas gérer PowerPoint seul ?

Sans bibliothèque de présentation, le code .NET peut écrire des fichiers PowerPoint grâce à l'Open XML SDK, qui crée une présentation partie par partie et relie les parties grâce à des relations.

IronPPT enrobe cette structure de package dans un petit modèle objet dont les principaux types sont PresentationDocument et Slide.

Trois faits s'appliquent avant la première sollicitation.

  • Un appel sans effet ne soulève aucune erreur : seule une lecture du fichier sauvegardé montre le changement manquant, et IronPPT effectue cette lecture lorsqu'il ouvre à nouveau le diaporama depuis son chemin.
  • Un seul nom pour le package et l'espace de noms : les deux s’appellent IronPPT. Les attaquants enregistrent des packages malveillants sous des noms que les assistants recommandent pour des packages qui n'existent pas, une pratique appelée slopsquatting, alors incluez le nom exact dans la sollicitation.
  • La licence est perpétuelle : une licence IronPPT est un achat unique sans frais de renouvellement, et la page des licences liste le nombre de développeurs autorisés par chaque niveau.

Étape 1 : Installer IronPPT

Avec le package référencé, l'assistant utilise les types fournis par IronPPT.

Install IronPPT 2026.10.1 from NuGet and restore the project.
Tell me the IronPPT version it references afterwards.
Text

Depuis un terminal, épinglez la version explicitement.

dotnet add package IronPPT --version 2026.10.1
SHELL

Le package ne contient pas de binaires natifs, et ses seules dépendances sont IronSoftware.Common et IronSoftware.System.Drawing.


Étape 2 : Appliquez votre clé de licence

Sans clé, un programme peut créer un diaporama en mémoire et ouvrir un fichier existant, mais chaque appel à Save échoue avec IronSoftware.Exceptions.LicensingException et le message Licence de production requise. Le message mentionne également sept jours d'utilisation gratuite pour le développement, cependant, l'enregistrement a échoué dès la première tentative dans cette enquête pour cet article. Une clé mal orthographiée entraîne le message Clé de licence non reconnue et le reste de ce message répète la clé. Une clé courte est apparue en entier, et une clé de longueur complète avec un caractère modifié est apparue sous la forme de ses 32 derniers caractères. Le code qui journalise les messages d'exception écrit donc le matériel de clé dans son journal. Une clé d'essai gratuite est disponible ci-dessous.

Commencez à utiliser IronPPT dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
arrow pointer

Assignez la clé de licence une fois au démarrage de l'application, avant tout appel à IronPPT. Récupérez-la depuis une variable d'environnement afin qu'elle ne soit pas stockée dans le dépôt.

IronPPT.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPPT_LICENSE_KEY");
C#

IronPPT.License.IsLicensed est défini sur vrai après qu'une clé valide soit assignée, et IronPPT.License.IsValidLicense indique si une chaîne de clé est valide. Sans l'assignation ci-dessus, IronPPT ignore IRONPPT_LICENSE_KEY. Il lit par contre les variables d'environnement nommées IronPPT.LicenseKey et IRONPPT_LICENSEKEY sans aucun code.

Veuillez noter: Clés de licence IronPPT explique également comment définir la clé dans appsettings.json.

Étape 3 : Orientez votre assistant vers la documentation LLM d'IronPPT

  • llms.txt contient une entrée d'une ligne pour chacune de ses 15 pages.
  • llms-full.txt fournit un résumé de chacune des 16 pages de documentation dans un seul fichier.
  • llms-full-catalog.txt étend l'index en incluant des articles de blog.
  • La référence API liste la signature de chaque membre.
  • Les outils qui supportent les fichiers de compétences peuvent utiliser skill.md, qui couvre l'installation, les licences, les recettes et les erreurs courantes.
  • La fiche de produit AI énumère les plateformes prises en charge et les cas d'utilisation principaux.

Fournissez l'index au début de chaque session.

Open https://ironsoftware.com/ppt/csharp/llms.txt before you write more IronPPT code.
Keep to what its linked pages document.

The IronPPT object model works like this:
- PresentationDocument is the deck, and a new one already holds one blank slide.
- AddSlide appends a Slide.
- Slide.AddText, Slide.AddParagraph and Slide.AddImage fill a slide.
- Slide.Remove deletes a slide, and setting Slide.Show to false hides it.
- Save writes the .pptx file, and the constructor that takes a path opens one.

For a member those pages leave out, do this:
1. Search https://ironsoftware.com/ppt/csharp/object-reference/api/ for it.
2. Build once to prove it compiles.
3. If you still can't confirm it, say so instead of guessing.

After that, list the IronPPT calls in this project that the docs don't cover.
Text

La permission de répondre « non documenté » donne à l'assistant une option autre qu'inventer une méthode.


Étape 4 : Ajoutez le contexte IronPPT à votre projet

Stockez les règles IronPPT dans un fichier d'instruction de projet pour que chaque nouvelle session puisse les lire. Claude Code lit CLAUDE.md, ChatGPT Codex lit AGENTS.md, GitHub Copilot lit .github/copilot-instructions.md, Cursor lit les fichiers .mdc dans .cursor/rules/ou AGENTS.md, et Google Antigravity lit AGENTS.md ou GEMINI.md. Un bloc de texte unique est compatible avec tous, bien que les fichiers de règles Cursor incluent également des préambules MDC. Commencez par ce qui suit.

Every deck in this project is built with IronPPT, under these rules:
- `IronPPT` is both the NuGet package name and the namespace.
- Begin with the llms.txt index, https://ironsoftware.com/ppt/csharp/llms.txt.
- Tools that read skill files load https://ironsoftware.com/ppt/csharp/skill.md.
- Set `IronPPT.License.LicenseKey` from IRONPPT_LICENSE_KEY when the app starts.
- The program reads that variable itself and never lists environment variables.
- Keep the key out of output, logs, exception text, and source control.
- A wrong key's `LicensingException` message repeats the key. Log only its first line.
- A new `PresentationDocument` already has one slide. Use `Slides[0]` as the title slide.
- Add text, paragraphs, and images through `Slide` methods.
- Build slides in their final order, or set `Slide.Index` to move one.
- Edits to the `Slides` list do not change the deck.
- Remove a slide with `Slide.Remove()` and hide one with `Show = false`.
- On a deck opened from disk, replace a picture by removing it and adding the new image.
- Do not add the Open XML SDK or another presentation library.
- When IronPPT lacks a feature, report that rather than working around it.
Markdown

Le fichier de compétences nomme IronPPT 2026.8.1 comme la version testée, et son exemple de fichier unique épingle cette version. Il décrit également Slides comme une liste qui peut être éditée pour réorganiser les diapositives et promet une période de développement de sept jours avant que Save ne nécessite une clé. Les sondages pour 2026.10.1 ont contredit ces deux affirmations.


Étape 5 : Invite de configuration en une seule fois

Les étapes 1 à 4 peuvent être envoyées ensemble comme un seul message au début d'un projet ou d'une session.

Set this project up for PowerPoint work with IronPPT, following these rules:
- Reference the IronPPT package at version 2026.10.1.
- Assign IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey first thing at startup.
- The code reads that variable itself. Don't list environment variables.
- The key never shows up in the console, a log, or a committed file.
- Before coding, go through https://ironsoftware.com/ppt/csharp/llms.txt, then keep to it.
- Look up anything it doesn't cover at https://ironsoftware.com/ppt/csharp/object-reference/api/.
- Compile before relying on a member found there.
- Load https://ironsoftware.com/ppt/csharp/skill.md if the tool accepts skill files.
- When the skill file and the compiler disagree, believe the compiler.
- Put content on slides with Slide methods, not with PresentationDocument.AddText.
- Create the slides in their final order, since editing the Slides list changes nothing.

Save these rules to the instructions file your next sessions read.
Tell me which file you wrote and what else you changed.
Text

Étape 6 : Modèles d'invite qui produisent un code fonctionnel

Spécifiez les diapositives, leur ordre et le contenu de chacune.

Vague Créer un diaporama trimestriel avec IronPPT.

Mieux Utilisez Slides[0] pour le titre, puis ajoutez une diapositive par région selon l'ordre des recettes, chacune avec un en-tête en gras de 32 points et trois paragraphes, et enregistrez quarterly.pptx.

Indiquez la version IronPPT et le cadre cible. Les membres peuvent changer entre les versions.

Mieux Utilisez IronPPT 2026.10.1 sur .NET 9, et assignez la clé de IronPPT_LICENSE_KEY avant le premier appel IronPPT.

Demandez des fichiers complets. Un extrait peut omettre la directive using IronPPT.Models;, qui fournit Slide, Text, et Image.

Mieux Retournez l'ensemble du fichier Program.cs, avec ses directives using et la ligne de licence, prêt à être compilé tel quel.


Étape 7 : Vérifiez ce que vous obtenez

Chacune des erreurs suivantes est reproductible en 2026.10.1.

  • Ajouter la diapositive de titre avec AddSlide : chaque nouveau PresentationDocument contient une diapositive depuis le début, construite sur la mise en page de titre. Un programme qui ajoute sa propre diapositive de titre enregistre un diaporama qui s'ouvre sur une diapositive vierge. Écrivez le titre sur Slides[0], ou ajoutez d'abord toutes les diapositives puis supprimez l'originale, car retirer la dernière diapositive d'un diaporama soulève InvalidOperationException.
  • Ajouter du texte dans le document : PresentationDocument.AddText a attaché son texte au dernier paragraphe de la dernière diapositive, et PresentationDocument.AddTextBox a créé une nouvelle diapositive pour la zone de texte. Ajoutez du contenu via les méthodes Slide.
  • Styler le résultat de AddText avec un argument de chaîne : le texte retourné n'a pas d'objet style, de sorte que définir une propriété dessus soulève NullReferenceException. La recette de style du fichier de compétences effectue cet appel. Assignez un nouveau TextStyle à la place.
  • Choisir une police avec FontFamily : l'exécution enregistrée ne transportait aucune police. LatinFont a écrit la police dans le fichier.

Un diaporama rouvert avec IronPPT retourne correctement son nombre de diapositives et son texte. Lisez la position, la taille, l'alignement et la couleur depuis le XML de la diapositive dans ppt/slides/slideN.xml. Après un rechargement, IronPPT a signalé le texte centré comme à gauche, et une enquête a lu les couleurs hexadécimales #C00000 et #FFC000 de retour sous la forme #00000000. La position, la taille et la taille de la police sont revenues à l'échelle EMU décrite sous output de texte et d'image.

Laissez l'agent vérifier son propre travail

L'assistant peut effectuer lui-même ces vérifications et présenter les résultats.

Do a clean Release build and run the app once more.

Then show me the evidence:
- The IronPPT types and members the code calls, each with its documentation page.
- The value of IronPPT.License.IsLicensed.
- Each saved deck's slide count and every slide's first line of text, read back from the file.
- Any hidden slide.
- Every shape's a:off, a:ext, algn and solidFill values, taken from ppt/slides/slideN.xml.
- Any image or text whose position, size, alignment or color differs from what the code set.

Read those four properties from the XML, never from a deck reopened with IronPPT.
End by saying whether each deck matches what the code meant to build.
Text

Édition de diapositive avec IronPPT

L'ordre des diapositives, la suppression et le remplacement des images se comportent différemment de ce que les guide de gestion des diapositives et guide de gestion des images montrent. Les sondages pour cet article ont enregistré chaque changement et ont relu les parties PPTX.

  • PresentationDocument.Slides retourne une nouvelle liste à chaque appel. Remove, Insert, RemoveAt, et Add sur cette liste n'ont rien changé dans le diaporama sauvegardé, donc l'exemple de réorganisation du guide laisse l'ordre tel quel.
  • Slide.Remove() a supprimé la diapositive, à la fois en mémoire et après que le diaporama a été chargé depuis un fichier.
  • Définir Show sur false a conservé la diapositive dans le fichier et l'a marquée comme cachée.
  • Slide.Clone() a lancé MissingMethodException, donc une diapositive ne peut pas être dupliquée.
  • Ajouter une diapositive supprimée avec AddSlide a produit une diapositive vierge.
  • Définir Slide.Index a déplacé une diapositive, à la fois dans un nouveau diaporama et dans un ouvert depuis le disque, et le fichier sauvegardé a conservé le nouvel ordre.
  • Slide.Images contient des valeurs IImage, donc l'appel Images[0].Replace(image) du guide se lie à la méthode de l'élément général Replace. Cet appel a remplacé l'image dans un diaporama construit en mémoire et a laissé l'ancienne image dans un diaporama ouvert depuis le disque.
  • La conversion de l'image en Image atteint Image.Replace, qui a fonctionné dans un diaporama rouvert et a lancé NullReferenceException dans un diaporama en mémoire.
  • Supprimer l'image et ajouter la nouvelle image avec AddImage a fonctionné dans les deux cas, bien que le package sauvegardé ait conservé l'ancienne image comme partie média inutilisée.

Output de texte et d'image avec IronPPT

Le XML de la diapositive sauvegardée et le validateur Open XML SDK 3.5.1 ont donné les résultats suivants.

  • Chaque appel à Slide.AddText a créé sa propre forme de texte de 150 par 100 points et n'a défini aucune position, de sorte que la forme hérite de son placement à partir de la mise en page de la diapositive.
  • AddParagraph a ajouté son paragraphe à la dernière forme de texte de la diapositive.
  • La première diapositive d'un nouveau diaporama gardait les espaces réservés de titre et de sous-titre vides à côté du texte que AddText a ajouté.
  • Les dimensions d'image Position, Width, et Height sont en points. Un PNG de 400 par 200 pixels sans résolution définie, ajouté sans taille, est devenu 300 par 150 points, sa taille en pixels à 96 DPI.
  • Dans un diaporama rouvert, les mêmes propriétés ont retourné les valeurs EMU stockées sous forme de points, soit 12 700 fois les valeurs définies.
  • FontSize avec Point défini sur 32 a écrit une taille de 32 points, et IsBold a écrit en gras.
  • Chaque exécution colorée via TextStyle.Color a échoué à la validation avec une erreur d'élément enfant invalide, pour les couleurs nommées et hexadécimales. Les diaporamas sans texte coloré ont été validés sans erreur.

Un résultat que vous pouvez reproduire

Le test consiste en un seul prompt, et vous n'écrivez aucun code. Ouvrez une nouvelle session dans un dossier vide, collez le prompt, et comparez le résultat avec les critères de réussite.

Veuillez noter: Le test nécessite le SDK .NET 9, une connexion réseau, un assistant capable d'exécuter des commandes terminales, et une clé d'essai ou de production IronPPT dans IRONPPT_LICENSE_KEY.

L'invite

Create a .NET 9 console app that builds a quarterly regional deck with IronPPT.
If this directory isn't empty, tell me and stop.
Don't ask questions. Note your choice for each missing detail.
Keep every deliverable in this directory.

Work in this order:
1. Add IronPPT 2026.10.1 from NuGet.
2. Study https://ironsoftware.com/ppt/csharp/llms.txt, its license key page and four how-to guides.
3. Follow these code rules:
- Use only members those pages or the API reference document.
- At startup, the program itself assigns IRONPPT_LICENSE_KEY to IronPPT.License.LicenseKey.
- Never print the key, save it, or list environment variables.
- Stop with a message if IronPPT.License.IsLicensed is false.
- Print only the first line of a licensing error from Save.
4. Before building slides, the code writes qbr-data.json in thousands of dollars:
- Revenue/target: North 1240/1100, South 860/950, East 1410/1300, West 720/900.
- Three commentary lines of your own per region, under 60 characters each.
5. Draw each region's revenue and target as an 800 by 400 pixel PNG bar chart:
- Save charts/<region>.png and a grey background copy, charts/<region>-board.png.
- Encode the PNGs yourself, with no package or imaging library.
6. Build qbr.pptx with these seven slides in order, none blank:
- Title: "Quarterly Business Review" in bold 40 point, "Q3 2026" in 24 point.
- A slide headed "Agenda" listing the four regions.
- One slide per region, highest revenue first.
- A last slide headed "Next steps" with a "South: 90K below target" line per region below target.

Each region slide has:
- Its name as a bold 32 point heading, then one paragraph per commentary line.
- "Revenue 1410K against a target of 1300K" with its figures.
- That line in Color.Green if the target is met, otherwise Color.Red.
- Its chart at x 360, y 140, 320 by 160, all in points.
7. Reopen qbr.pptx from disk and save a board version, qbr-board.pptx, like this:
- Drop the agenda slide.
- Hide "Next steps" without removing it.
- Move the region with the largest shortfall right after the title.
- Swap that region's chart for its -board.png.
- Keep the rest in original order.
- Work around and note any change the save loses.
- As a last resort, rebuild from your data in the new order.
8. Build and run in Release.

The app fills readback.md only from both saved decks, reopened with IronPPT:
- A table per deck of each slide's position, first text line, visibility and image count.
- A section on each step where the guides' approach didn't work.

Its checks give expected, actual and match for both decks:
- Slide count and region order.
- Revenue line color, chart position and size per region slide.
- The board deck's moved region chart against its -board.png, by image bytes.
9. Fix each failed check and rerun, or describe an IronPPT cause nothing gets around and move on.
10. Report the Release build result, checks matched out of total, and your assumptions.
Text

Sortie

La readback.md non éditée de l'application liste ses tableaux de diapositives et de vérifications, et les deux diaporamas sont disponibles tels que l'application les a sauvegardés, qbr.pptx et qbr-board.pptx. Les chiffres ci-dessous proviennent d'une lecture indépendante des parties PPTX sauvegardées.

Graphique à barres de revenus de la région Ouest par rapport à l'objectif, dessiné par l'application générée

La version à tableau gris du graphique Ouest, telle que l'application l'a dessinée avec son propre encodeur PNG et l'a placée dans qbr-board.pptx, non éditée.

  • Une build Release pour net9.0 s'est terminé sans avertissements ni erreurs.
  • qbr.pptx contenait sept diapositives dans l'ordre demandé, et aucune d'entre elles n'était vierge.
  • L'application a supprimé la diapositive avec laquelle un nouveau diaporama commence en appelant Remove dessus, après que l'appel à liste du guide n'a eu aucun effet.
  • Chaque en-tête de région était en gras à 32 points.
  • Les lignes de revenus étaient vertes pour le Nord et l'Est et rouges pour le Sud et l'Ouest.
  • Toutes les huit diapositives régionales dans les deux diaporamas plaçaient le graphique à x 360 et y 140 points, dimensionné à 320 par 160 points.
  • qbr-board.pptx avait six diapositives, avec l'Ouest, à 180K sous l'objectif, directement après le titre.
  • Seule la diapositive Next steps était cachée dans le diaporama du tableau.
  • L'application a construit le diaporama du tableau à partir de qbr.pptx tel qu'ouvert depuis le disque et a déplacé West en définissant la propriété Index de sa diapositive.
  • La diapositive West dans le diaporama du tableau transportait les octets exacts du PNG du graphique que l'application a écrit.
  • La relecture de l'application correspondait à 22 sur 22 vérifications.
  • La lecture indépendante a correspondu à toutes les 60 vérifications.
  • Le validateur Open XML SDK a signalé six erreurs dans chaque diaporama, une pour chaque exécution colorée.
  • Aucun fichier dans le dossier du projet, son historique Git ni les fichiers de session Claude Code ne contenaient la clé de licence.
  • Le prompt d'installation a écrit ses onze règles dans un nouveau CLAUDE.md et a installé skill.md comme compétence de projet.
  • Certaines étapes ont été exécutées différemment de la page. Les prompts des étapes 1, 3, 5 et 7 ont été exécutés après le prompt d'acceptation dans la même session.

Ce qui passe

  • Une build Release s'achève sans aucune édition manuelle.
  • qbr.pptx a sept diapositives dans l'ordre défini à l'étape 6, aucune n'étant vierge, lorsque vous lisez le fichier vous-même.
  • Chaque diapositive régionale contient son en-tête, trois paragraphes de commentaire, la ligne de revenus, et un graphique à la position et à la taille demandées.
  • qbr-board.pptx a six diapositives, avec la région qui a manqué son objectif de plus juste après le titre et la diapositive Next steps cachée.
  • readback.md prend chaque valeur réelle des diaporamas sauvegardés et nomme chaque étape qui nécessitait une approche différente.
  • Une recherche dans le dossier du projet ne trouve aucun fichier contenant la clé de licence.
Veuillez noter: Pour tester une version différente, modifiez la version à l'étape 1 et consultez le journal des modifications d'IronPPT pour les changements.

L'enregistrement de l'exécution

  • Toutes les exécutions ont utilisé un ordinateur de bureau Windows 11 x64 avec un Core i9-14900KF et 64 Go de mémoire.
  • Le projet de ce guide cible net9.0 et épingle IronPPT 2026.10.1.
  • La durée d'un guide est la somme des temps enregistrés pour les prompts sur sa page, et cette ligne de guide ne compte que le prompt d'acceptation.
  • Dernier test le 16 octobre 2026, pour chaque guide du tableau.
GuideAssistant et versionModèleDurée (minutes)
Ce guideClaude Code 2.1.277, une session, invites de permission désactivéesClaude Opus 518.2
Claude CodeClaude Code 2.1.277, invite 3 en mode planSonnet 5 avec Opus 5 planning33.3
ChatGPT CodexCLI Codex 0.160.0GPT-6 Luna22.2
GitHub CopilotCopilot CLI 1.0.98, prompt 3 en mode plan, le corps de l'émission et l'examen dans leurs propres sessionsGPT-6 Luna, choisi par Auto16.1
CursorCursor CLI 2026.10.14, mode sans tête, prompt 3 en mode plan, qui est resté allumé pour les prompts 5 à 7Composer 2.515.4
Google AntigravityAntigravity CLI 1.4.0, invites d'autorisation ignoréesGemini 4 Argon (Moyen)47.4

Guides spécifiques aux agents

Chaque guide ci-dessous applique ces étapes à un outil et une tâche de présentation.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 7,110Version :2026.11tout juste publié