L'en-tête disparaît après SaveAs dans IronWord

Curtis Chau
Curtis Chau
Mis à jour : 2 août 2026
Veuillez noter: Ce comportement n'a été signalé que dans un seul environnement et n'est pas corroboré par le journal des modifications d'IronWord - d'autres guides d'IronWord utilisent SaveAs() comme leur appel d'enregistrement standard sans perte d'en-tête signalée. Traitez ceci comme une bizarrerie potentiellement spécifique à l'environnement plutôt qu'un défaut de produit confirmé, et vérifiez dans votre propre environnement avant d'appliquer la solution ci-dessous.

Dans certains environnements, il a été observé que le remplissage d'un modèle DOCX avec IronWord et l'écriture du résultat avec SaveAs() pouvaient entraîner la perte de l'en-tête du modèle dans le fichier généré, même si les espaces réservés sont correctement fusionnés.

Header (e.g. "City Attorney Cover Sheet") is visible in the original DOCX
but missing in the generated file after calling SaveAs().
Text

Modèle Word avec espaces réservés non remplacés et sans en-tête

Dans l'environnement où cela a été observé, l'en-tête a été préservé lors de l'écriture du document avec Save() plutôt qu'avec SaveAs(). Cela n'a pas été corroboré dans d'autres environnements ou dans le journal des modifications d'IronWord - d'autres guides d'IronWord utilisent SaveAs() comme leur appel d'enregistrement standard sans problème de perte d'en-tête, donc considérez ceci comme spécifique à l'environnement plutôt qu'un défaut de produit confirmé.

Solution

1. Charger le modèle

Ouvrez le DOCX source avec WordDocument.

using IronWord;
using System.Collections.Generic;

var templatePath = @"C:\Templates\CityAttorneyCoverSheetTemplate.docx";
var outputPath   = @"C:\Output\merged.docx";

var doc = new WordDocument(templatePath);

2. Remplacer les espaces réservés

Fusionnez vos valeurs via doc.Texts, une approche simple de recherche/remplacement ; pour les modèles avec de nombreux espaces réservés utilisant la syntaxe MERGEFIELD, l'API dédiée d'IronWord WordDocument.MailMerge est également disponible.

var replacements = new Dictionary<string, string>
{
    ["{CaseNumber}"] = "2026-CR-12345",
    ["{DefendantName}"] = "John Doe",
    ["{DefendantAge}"] = "34",
    ["{DefendantAttorney}"] = "Jane Smith",
};

foreach (var kv in replacements)
{
    doc.Texts.ForEach(t => t.Replace(kv.Key, kv.Value));
}

Le parcours des entrées et leur application à doc.Texts remplacent chaque espace réservé par sa valeur de fusion dans le corps du document.

3. Enregistrer avec Save(), pas SaveAs()

Dans l'environnement où ce problème a été observé, l'écriture du résultat avec doc.Save(outputPath) a conservé l'en-tête intact, tandis que doc.SaveAs(outputPath) l'a supprimé. Considérez ceci comme une solution à essayer, non pas comme une différence de comportement universelle confirmée entre les deux méthodes.

doc.Save(outputPath);

Document Word fusionné avec l'en-tête préservé et les espaces réservés remplis

Remarques

  • Si votre flux de travail nécessite SaveAs() : vérifiez avec la dernière version d'IronWord si l'en-tête est conservé dans votre environnement.
  • Si le problème réapparaît : fixez la version utilisée à une version antérieure qui fonctionnait, à titre de mesure temporaire pendant l'analyse du comportement.
Veuillez noter: Les espaces réservés sont toujours trouvés et remplacés pendant la traversée, même lorsque l'en-tête est perdu, donc une fusion réussie seule n'est pas une confirmation que l'en-tête a été conservé. Ouvrez le résultat et vérifiez.

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 62,392Version :2026.11tout juste publié