Compartir a través de


Leer y escribir en las propiedades del documento

Puede almacenar propiedades de documento junto con un documento. Las aplicaciones de Office proporcionan una serie de propiedades integradas, como author, title y subject. En este tema se muestra cómo establecer las propiedades de documento en Microsoft Office Excel y Microsoft Office Word.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO para las siguientes aplicaciones: Excel; Powerpoint; Proyecto; Palabra. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Establecimiento de propiedades de documento en Excel

Para trabajar con las propiedades integradas de Excel, use las siguientes propiedades:

  • En un proyecto de nivel de documento, use la propiedad BuiltinDocumentProperties de la clase ThisWorkbook .

  • En un proyecto de complemento de VSTO, use la propiedad BuiltinDocumentProperties de un objeto Workbook .

    Estas propiedades devuelven un objeto DocumentProperties , que es una colección de objetos DocumentProperty . Puede usar la propiedad Item de la colección para recuperar una propiedad determinada, ya sea por nombre o por índice dentro de la colección.

    En el siguiente ejemplo de código se muestra cómo cambiar la propiedad integrada Revision Number en un proyecto de nivel de documento.

Para cambiar la propiedad Revision Number en Excel

  1. Asigne las propiedades integradas del documento a una variable.

    Microsoft.Office.Core.DocumentProperties properties;
    
    properties = (Microsoft.Office.Core.DocumentProperties)
        Globals.ThisWorkbook.BuiltinDocumentProperties; 
    
    Microsoft.Office.Core.DocumentProperty prop;
    prop = properties["Revision Number"];
    
  2. Incremente la propiedad Revision Number en uno.

    if (prop.Value == null)
    {
        prop.Value = 1;
    }
    else
    {
        int revision;
        if (int.TryParse((string)prop.Value, out revision))
        {
            prop.Value = revision + 1;
            MessageBox.Show("Revision Number = " + revision);
        }
        else
        {
            MessageBox.Show("Revision Number = invalid value");
        }
    }
    

Establecer propiedades de documento en Word

Para trabajar con las propiedades integradas de Word, use las siguientes propiedades:

  • En un proyecto de nivel de documento, use la propiedad BuiltInDocumentProperties de la clase ThisDocument .

  • En un proyecto de complemento de VSTO, use la propiedad BuiltInDocumentProperties de un objeto Document .

    Estas propiedades devuelven un objeto DocumentProperties , que es una colección de objetos DocumentProperty . Puede usar la propiedad Item de la colección para recuperar una propiedad determinada, ya sea por nombre o por índice dentro de la colección.

    En el siguiente ejemplo de código se muestra cómo cambiar la propiedad integrada Subject en un proyecto de nivel de documento.

Para cambiar la propiedad Subject

  1. Asigne las propiedades integradas del documento a una variable.

    Microsoft.Office.Core.DocumentProperties properties;
    
    properties = (Microsoft.Office.Core.DocumentProperties)
        Globals.ThisDocument.BuiltInDocumentProperties;
    
  2. Cambie la propiedad Subject a «Whitepaper».

    // Set the Subject property. 
    properties["Subject"].Value = "Whitepaper";
    

Programación sólida

En los ejemplos se supone que ha escrito el código de la clase ThisWorkbook en un proyecto de nivel de documento para Excel y la clase ThisDocument en un proyecto de nivel de documento para Word.

Aunque trabaje con Word y Excel y sus objetos, Microsoft Office proporciona una lista de propiedades de documento integradas. Si se intenta tener acceso a una propiedad sin definir, se produce una excepción.