C#/VB.NET : ajouter des propriétés de document aux documents Word

2023-09-04 06:28:07

Les propriétés du document (également appelées métadonnées) sont un ensemble d'informations sur un document. Tous les documents Word sont livrés avec un ensemble de propriétés de document intégrées, notamment le titre, le nom de l'auteur, le sujet, les mots-clés, etc. En plus des propriétés de document intégrées, Microsoft Word permet également aux utilisateurs d'ajouter des propriétés de document personnalisées aux documents Word. Dans cet article, nous expliquerons comment ajouter ces propriétés de document aux documents Word en C# et VB.NET en utilisant Spire.Doc for .NET.

Installer Spire.Doc for .NET

Pour commencer, vous devez ajouter les fichiers DLL inclus dans le package Spire.Doc for.NET comme références dans votre projet .NET. Les fichiers DLL peuvent être téléchargés à partir de ce lien ou installés via NuGet.

PM> Install-Package Spire.Doc

Ajouter des propriétés de document intégrées à un document Word en C# et VB.NET

Une propriété de document intégrée se compose d'un nom et d'une valeur. Vous ne pouvez pas définir ou modifier le nom d'une propriété de document intégrée car elle est prédéfinie par Microsoft Word, mais vous pouvez définir ou modifier sa valeur. Les étapes suivantes montrent comment définir les valeurs des propriétés de document intégrées dans un document Word :

  • Initialisez une instance de la classe Document.
  • Chargez un document Word à l'aide de la méthode Document.LoadFromFile().
  • Obtenez les propriétés de document intégrées du document via la propriété Document.BuiltinDocumentProperties.
  • Définissez des valeurs pour des propriétés de document spécifiques telles que le titre, le sujet et l'auteur via les propriétés Titre, Sujet et Auteur de la classe BuiltinDocumentProperties.
  • Enregistrez le document résultat à l'aide de la méthode Document.SaveToFile().
  • C#
  • VB.NET
using Spire.Doc;
    
    namespace BuiltinDocumentProperties
    {
        class Program
        {
            static void Main(string[] args)
            {
                //Create a Document instance
                Document document = new Document();
                //Load a Word document
                document.LoadFromFile("Sample.docx");
    
                //Add built-in document properties to the document
                BuiltinDocumentProperties standardProperties = document.BuiltinDocumentProperties;
                standardProperties.Title = "Add Document Properties";
                standardProperties.Subject = "C# Example";
                standardProperties.Author = "James";
                standardProperties.Company = "Eiceblue";
                standardProperties.Manager = "Michael";
                standardProperties.Category = "Document Manipulation";
                standardProperties.Keywords = "C#, Word, Document Properties";
                standardProperties.Comments = "This article shows how to add document properties";
    
                //Save the result document
                document.SaveToFile("StandardDocumentProperties.docx", FileFormat.Docx2013);
            }
        }
    }

C#/VB.NET: Add Document Properties to Word Documents

Ajouter des propriétés de document personnalisées à un document Word en C# et VB.NET

Une propriété de document personnalisée peut être définie par un auteur ou un utilisateur de document. Chaque propriété de document personnalisée doit contenir un nom, une valeur et un type de données. Le type de données peut être l'un des quatre types suivants : Texte, Date, Nombre et Oui ou Non. Les étapes suivantes montrent comment ajouter des propriétés de document personnalisées avec différents types de données à un document Word :

  • Initialisez une instance de la classe Document.
  • Chargez un document Word à l'aide de la méthode Document.LoadFromFile().
  • Obtenez les propriétés personnalisées du document via la propriété Document.CustomDocumentProperties.
  • Ajoutez des propriétés de document personnalisées avec différents types de données au document à l'aide de la méthode CustomDocumentProperties.Add(string, object).
  • Enregistrez le document résultat à l'aide de la méthode Document.SaveToFile().
  • C#
  • VB.NET
using Spire.Doc;
    using System;
    
    namespace CustomDocumentProperties
    {
        class Program
        {
            static void Main(string[] args)
            {
                //Create a Document instance
                Document document = new Document();
                //Load a Word document
                document.LoadFromFile("Sample.docx");
    
                //Add custom document properties to the document
                CustomDocumentProperties customProperties = document.CustomDocumentProperties;
                customProperties.Add("Document ID", 1);
                customProperties.Add("Authorized", true);
                customProperties.Add("Authorized By", "John Smith");
                customProperties.Add("Authorized Date", DateTime.Today);
    
                //Save the result document
                document.SaveToFile("CustomDocumentProperties.docx", FileFormat.Docx2013);
            }
        }
    }

C#/VB.NET: Add Document Properties to Word Documents

Demander une licence temporaire

Si vous souhaitez supprimer le message d'évaluation des documents générés ou vous débarrasser des limitations fonctionnelles, veuillez demander une licence d'essai de 30 jours pour toi.

Voir également