Cómo: Leer y escribir en propiedades de un documento

Artículo
02/19/2013

Propiedades de documento se pueden almacenar junto con un documento.Las aplicaciones de Office proporcionan varias propiedades integradas, como autor, title, y asunto.En este tema se muestra cómo establecer las propiedades de documento en Microsoft Office Excel y Microsoft Office Word.

vínculo a vídeo Dispone de una demostración en vídeo relacionada en How Do I: Access and Manipulate Custom Document Properties in Microsoft Word?.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para las siguientes aplicaciones: Excel 2013 y Excel 2010; PowerPoint 2013 y PowerPoint 2010; Project 2013 y Project 2010; Word 2013 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Establecer propiedades de documento en Excel

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

En un proyecto de nivel de documento, use la propiedad BuiltinDocumentProperties de la clase ThisWorkbook.
En un proyecto de nivel de aplicación, use la propiedad BuiltinDocumentProperties de un objeto Microsoft.Office.Interop.Excel.Workbook.

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

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

Para cambiar la propiedad Revision Number en Excel

Asigne las propiedades de documento integradas a una variable.

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisWorkbook.BuiltinDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Dim prop As Microsoft.Office.Core.DocumentProperty
prop = properties.Item("Revision Number")

Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisWorkbook.BuiltinDocumentProperties; 

Microsoft.Office.Core.DocumentProperty prop;
prop = properties["Revision Number"];

Incremente la propiedad Revision Number en uno.

If prop.Value Is Nothing Then
    prop.Value = 1
Else
    Dim revision As Integer
    If Integer.TryParse(prop.Value.ToString(), revision) Then
        prop.Value = revision + 1
        MessageBox.Show("Revision Number = " & revision)
    Else
        MessageBox.Show("Revision Number = invalid value")
    End If
End If

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 propiedades siguientes:

En un proyecto de nivel de documento, use la propiedad BuiltInDocumentProperties de la clase ThisDocument.
En un proyecto de nivel de aplicación, use la propiedad BuiltInDocumentProperties de un objeto Microsoft.Office.Interop.Word.Document.

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

Para cambiar la propiedad Subject

Asigne las propiedades de documento integradas a una variable.

Dim properties As Microsoft.Office.Core.DocumentProperties

properties = DirectCast(Globals.ThisDocument.BuiltInDocumentProperties, _
    Microsoft.Office.Core.DocumentProperties)

Microsoft.Office.Core.DocumentProperties properties;

properties = (Microsoft.Office.Core.DocumentProperties)
    Globals.ThisDocument.BuiltInDocumentProperties;

Cambie la propiedad Subject a "Notas del producto".

' Set the Subject property.
properties.Item("Subject").Value = "Whitepaper"

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

Programación eficaz

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.