Administrar propiedades del documento

Introducción

Microsoft Excel proporciona la capacidad de agregar propiedades a los archivos de hojas de cálculo. Estas propiedades del documento proporcionan información útil y se dividen en 2 categorías como se detalla a continuación.

Propiedades predeterminadas del sistema (integradas): Las propiedades integradas contienen información general sobre el documento, como el título del documento, el nombre del autor, estadísticas del documento, entre otros.
Propiedades definidas por el usuario (personalizadas): Propiedades personalizadas definidas por el usuario final en forma de par nombre-valor.

El punto más importante a tener en cuenta sobre las propiedades integradas y personalizadas es que las propiedades integradas se pueden acceder y modificar, pero no crear ni eliminar. Sin embargo, las propiedades personalizadas se pueden crear y gestionar.

Cómo administrar propiedades de documento utilizando Microsoft Excel

Microsoft Excel le permite administrar las propiedades de documento de los archivos de Excel de forma WYSIWYG. Siga los siguientes pasos para abrir el diálogo Propiedades en Excel 2016.

Desde el menú Archivo, seleccione Información.

Seleccionar menú Información

Haga clic en el encabezado Propiedades y seleccione “Propiedades avanzadas”.

Haciendo clic en la selección de Propiedades avanzadas

Administre las propiedades del documento del archivo.

Cuadro de propiedades

En el cuadro de propiedades, hay pestañas diferentes, como General, Resumen, Estadísticas, Contenidos y Aduanas. Cada pestaña ayuda a configurar diferentes tipos de información relacionada con el archivo. La pestaña Aduanas se usa para gestionar propiedades personalizadas.

Cómo trabajar con las propiedades del documento usando Aspose.Cells

Los desarrolladores pueden gestionar dinámicamente las propiedades del documento usando las APIs de Aspose.Cells. Esta característica ayuda a los desarrolladores a almacenar información útil junto con el archivo, como cuándo se recibió el archivo, se procesó, se marcó con la hora, y así sucesivamente.

Aspose.Cells for .NET escribe directamente la información sobre API y el número de versión en los documentos de salida. Por ejemplo, al representar un documento a PDF, Aspose.Cells for .NET llena el campo Aplicación con el valor ‘Aspose.Cells’ y el campo Productor de PDF con el valor, por ejemplo ‘Aspose.Cells v17.9’.

Tenga en cuenta que no puede indicar a Aspose.Cells for .NET que cambie o elimine esta información de los documentos de salida.

Cómo acceder a las propiedades del documento

Las APIs de Aspose.Cells admiten tanto tipos de propiedades de documentos integrados como personalizados. La clase Workbook de Aspose.Cells representa un archivo de Excel y, al igual que un archivo de Excel, la clase Workbook puede contener múltiples hojas de cálculo, cada uno representado por la clase Worksheet, mientras que la colección de hojas de cálculo es representada por la clase WorksheetCollection.

Utilice el WorksheetCollection para acceder a las propiedades del documento del archivo como se describe a continuación.

Para acceder a las propiedades de documento integradas, use WorksheetCollection.BuiltInDocumentProperties.
Para acceder a las propiedades de documento personalizadas, use WorksheetCollection.CustomDocumentProperties.

Tanto WorksheetCollection.BuiltInDocumentProperties como WorksheetCollection.CustomDocumentProperties devuelven la instancia de Aspose.Cells.Properties.DocumentPropertyCollection. Esta colección contiene objetos de Aspose.Cells.Properties.DocumentProperty, cada uno de los cuales representa una única propiedad de documento integrada o personalizada.

Depende de los requisitos de la aplicación cómo acceder a una propiedad, es decir; utilizando el índice o el nombre de la propiedad de DocumentPropertyCollection como se demuestra en el ejemplo a continuación.

La clase Aspose.Cells.Properties.DocumentProperty permite recuperar el nombre, valor y tipo de la propiedad del documento:

Para obtener el nombre de la propiedad, use DocumentProperty.Name.
Para obtener el valor de la propiedad, use DocumentProperty.Value. DocumentProperty.Value devuelve el valor como un Objeto.
Para obtener el tipo de propiedad, use DocumentProperty.Type. Esto devuelve uno de los valores de enumeración de PropertyType. Después de obtener el tipo de propiedad, use uno de los métodos DocumentProperty.ToXXX para obtener el valor del tipo apropiado en lugar de usar DocumentProperty.Value. Los métodos DocumentProperty.ToXXX se describen en la tabla a continuación.

La clase DocumentProperty también proporciona un conjunto de métodos que devuelven los valores de otros tipos de datos.

Nombre de Miembro	Descripción	Método ToXXX
Boolean	El tipo de dato de propiedad es Booleano	ABoolean
Date	El tipo de datos de la propiedad es DateTime. Tenga en cuenta que Microsoft Excel solo almacena la parte de la fecha, no se puede almacenar la hora en una propiedad personalizada de este tipo	ToDateTime
Float	El tipo de datos de la propiedad es Double	ToDouble
Number	El tipo de datos de la propiedad es Int32	ToInt
String	El tipo de datos de la propiedad es String	ToString

Cómo agregar o eliminar propiedades de documento personalizadas

Como hemos descrito anteriormente al principio de este tema, los desarrolladores no pueden agregar o eliminar propiedades integradas porque estas propiedades están definidas por el sistema, pero es posible agregar o eliminar propiedades personalizadas porque estas son definidas por el usuario.

Cómo agregar propiedades personalizadas

Las APIs de Aspose.Cells han expuesto el método Add para la clase CustomDocumentPropertyCollection con el fin de agregar propiedades personalizadas a la colección. El método Add agrega la propiedad al archivo de Excel y devuelve una referencia para la nueva propiedad de documento como un objeto Aspose.Cells.Properties.DocumentProperty

Cómo configurar la propiedad personalizada de “Vínculo con contenido”

Para crear una propiedad personalizada vinculada al contenido de un rango dado, llame al método CustomDocumentPropertyCollection.AddLinkToContent y pase el nombre de la propiedad y la fuente. Puede verificar si una propiedad está configurada como vinculada con el contenido usando la propiedad DocumentProperty.IsLinkedToContent. Además, también es posible obtener el rango de origen utilizando la propiedad Source de la clase DocumentProperty

Utilizamos un archivo de plantilla simple de Microsoft Excel en el ejemplo. El libro de trabajo tiene un rango con nombre definido etiquetado como MiRango que se refiere a un valor de celda.

Cómo eliminar propiedades personalizadas

Para eliminar propiedades personalizadas mediante Aspose.Cells, llame al método DocumentPropertyCollection.Remove y pase el nombre de la propiedad del documento que se va a eliminar.

Temas avanzados

Imprimir y vista previa de libro de trabajo Administrar hojas de cálculo de archivos de Microsoft Excel