Cómo: Leer y escribir en propiedades de un documento
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.
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.
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 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