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

Las propiedades de documento se pueden almacenar con el documento en las aplicaciones de Microsoft Office enumeradas anteriormente. Estas aplicaciones proporcionan varias propiedades integradas, como autor, título 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 2007 y Excel 2010; PowerPoint 2007 y PowerPoint 2010; Project 2007 y Project 2010; Word 2007 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.

Vea también

Tareas

Cómo: Crear y modificar propiedades personalizadas para documentos

Otros recursos

Programar complementos de nivel de aplicación

Programar personalizaciones de nivel de documento

Last updated on 2011-08-10