Utilisation d'IronPPT avec les assistants de codage AI
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.
Comment utiliser IronPPT avec un assistant de codage AI
- Télécharger la bibliothèque C# PowerPoint depuis NuGet
- Assignez
IronPPT.License.LicenseKeyà partir deIronPPT_LICENSE_KEYau démarrage - Donnez à l'assistant l'index llms.txt d'IronPPT avant qu'il n'écrive du code
- Enregistrez les règles d'IronPPT dans le fichier d'instructions que votre assistant charge
- Utilisez la diapositive qu'un nouveau diaporama contient déjà, puis ajoutez le reste dans leur ordre final
- Vérifiez le XML de chaque diaporama sauvegardé par rapport à la demande
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.
Depuis un terminal, épinglez la version explicitement.
dotnet add package IronPPT --version 2026.10.1
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.
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");
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.
É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.
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.
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.
É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 nouveauPresentationDocumentcontient 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 surSlides[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.AddTexta attaché son texte au dernier paragraphe de la dernière diapositive, etPresentationDocument.AddTextBoxa créé une nouvelle diapositive pour la zone de texte. Ajoutez du contenu via les méthodesSlide. - Styler le résultat de
AddTextavec 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 nouveauTextStyleà la place. - Choisir une police avec
FontFamily: l'exécution enregistrée ne transportait aucune police.LatinFonta é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.
É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.Slidesretourne une nouvelle liste à chaque appel.Remove,Insert,RemoveAt, etAddsur 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
Showsur 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
AddSlidea produit une diapositive vierge. - Définir
Slide.Indexa 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.Imagescontient des valeursIImage, donc l'appelImages[0].Replace(image)du guide se lie à la méthode de l'élément généralReplace. 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
ImageatteintImage.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
AddImagea 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.AddTexta 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. AddParagrapha 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
AddTexta ajouté. - Les dimensions d'image
Position,Width, etHeightsont 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.
FontSizeavecPointdéfini sur 32 a écrit une taille de 32 points, etIsBolda écrit en gras.- Chaque exécution colorée via
TextStyle.Colora é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.
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.
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.

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.
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
IronPPT2026.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.
| Guide | Assistant et version | Modèle | Durée (minutes) |
|---|---|---|---|
| Ce guide | Claude Code 2.1.277, une session, invites de permission désactivées | Claude Opus 5 | 18.2 |
| Claude Code | Claude Code 2.1.277, invite 3 en mode plan | Sonnet 5 avec Opus 5 planning | 33.3 |
| ChatGPT Codex | CLI Codex 0.160.0 | GPT-6 Luna | 22.2 |
| GitHub Copilot | Copilot CLI 1.0.98, prompt 3 en mode plan, le corps de l'émission et l'examen dans leurs propres sessions | GPT-6 Luna, choisi par Auto | 16.1 |
| Cursor | Cursor CLI 2026.10.14, mode sans tête, prompt 3 en mode plan, qui est resté allumé pour les prompts 5 à 7 | Composer 2.5 | 15.4 |
| Google Antigravity | Antigravity CLI 1.4.0, invites d'autorisation ignorées | Gemini 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.
- Utilisez IronPPT avec Claude Code pour les documents de formation avec du texte stylé
- Utilisez IronPPT avec ChatGPT Codex pour un diaporama de ventes hebdomadaire assemblé à partir d'un modèle
- Utilisez IronPPT avec GitHub Copilot pour un diaporama de liste de propriétés avec photos
- Utilisez IronPPT avec Cursor pour porter le générateur de rapports SDK Open XML d'une école vers IronPPT
- Utilisez IronPPT avec Google Antigravity pour une application web qui construit un diaporama de statut de projet à télécharger
Dépannage
- Clés de licence IronPPT si
Savelance une exception de licence - Demande de support technique si un diaporama sauvegardé diffère du code et que la section d'édition de diapositive n'explique pas pourquoi
- Gérer les images si une image n'est pas là où le code l'a placée
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.