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

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Versión de Microsoft Office Microsoft Office System 2007 Microsoft Office 2003 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Puede almacenar las propiedades del documento con el documento o libro en las personalizaciones de nivel de documento para Microsoft Office Word y Microsoft Office Excel. Excel y Word proporcionan varias propiedades integradas, como autor, título y asunto.

Establecer propiedades de documento en Excel

Utilice la propiedad BuiltinDocumentProperties de la clase ThisWorkbook para trabajar con propiedades integradas. Esta propiedad devuelve 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.

Para cambiar la propiedad Revision Number en Excel

1. 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"]; 
   

2. 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

Utilice la propiedad BuiltInDocumentProperties de la clase ThisDocument para trabajar con propiedades integradas. Esta propiedad devuelve 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.

Para cambiar la propiedad Subject

1. 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; 
   

2. 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

Los ejemplos suponen que ha escrito el código en la clase ThisWorkbook para Excel y en la clase ThisDocument 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 la propiedad Value para buscar propiedades no definidas, se inicia una excepción.

Vea también

Tareas

Cómo: Crear y modificar propiedades personalizadas para documentos

Conceptos

Programar personalizaciones de nivel de documento