C#/VB.NET: Adicionar propriedades de documento a documentos do Word

2023-09-04 06:34:07

As propriedades do documento (também conhecidas como metadados) são um conjunto de informações sobre um documento. Todos os documentos do Word vêm com um conjunto de propriedades de documento integradas, incluindo título, nome do autor, assunto, palavras-chave, etc. Além das propriedades de documento integradas, o Microsoft Word também permite que os usuários adicionem propriedades de documento personalizadas a documentos do Word. Neste artigo, explicaremos como adicione essas propriedades de documento a documentos do Word em C# e VB.NET usando Spire.Doc for .NET.

Instale o Spire.Doc for .NET

Para começar, você precisa adicionar os arquivos DLL incluídos no pacote Spire.Doc for.NET como referências em seu projeto .NET. Os arquivos DLL podem ser baixados deste link ou instalados via NuGet.

PM> Install-Package Spire.Doc

Adicionar propriedades de documento integradas a um documento do Word em C# e VB.NET

Uma propriedade de documento integrada consiste em um nome e um valor. Você não pode definir ou alterar o nome de uma propriedade interna do documento, pois ela é predefinida pelo Microsoft Word, mas pode definir ou alterar seu valor. As etapas a seguir demonstram como definir valores para propriedades internas do documento em um documento do Word:

  • Inicialize uma instância da classe Document.
  • Carregue um documento do Word usando o método Document.LoadFromFile().
  • Obtenha as propriedades internas do documento por meio da propriedade Document.BuiltinDocumentProperties.
  • Defina valores para propriedades específicas do documento, como título, assunto e autor, por meio das propriedades Título, Assunto e Autor da classe BuiltinDocumentProperties.
  • Salve o documento resultante usando o método 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

Adicionar propriedades de documento personalizadas a um documento do Word em C# e VB.NET

Uma propriedade de documento personalizada pode ser definida por um autor ou usuário do documento. Cada propriedade personalizada do documento deve conter um nome, um valor e um tipo de dados. O tipo de dados pode ser um destes quatro tipos: Texto, Data, Número e Sim ou Não. As etapas a seguir demonstram como adicionar propriedades de documento personalizadas com diferentes tipos de dados a um documento do Word:

  • Inicialize uma instância da classe Document.
  • Carregue um documento do Word usando o método Document.LoadFromFile().
  • Obtenha as propriedades personalizadas do documento por meio da propriedade Document.CustomDocumentProperties.
  • Adicione propriedades de documento personalizadas com diferentes tipos de dados ao documento usando o método CustomDocumentProperties.Add(string, object).
  • Salve o documento resultante usando o método 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

Solicite uma licença temporária

Se desejar remover a mensagem de avaliação dos documentos gerados ou se livrar das limitações de função, por favor solicite uma licença de teste de 30 dias para você mesmo.

Veja também