Administrar propiedades del documento

Introducción

Microsoft Excel ofrece la posibilidad de agregar propiedades a 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 definidas por el sistema (integradas): las propiedades integradas contienen información general sobre el documento, como el título del documento, el nombre del autor, las estadísticas del documento, etc.
Propiedades definidas por el usuario (personalizadas): propiedades personalizadas definidas por el usuario final en forma de par nombre-valor.

El punto más importante que debe saber sobre las propiedades integradas y personalizadas es que se puede acceder a las propiedades integradas y modificarlas, pero no crearlas ni eliminarlas. Sin embargo, se pueden crear y administrar propiedades personalizadas.

Cómo administrar las propiedades del documento usando Microsoft Excel

Microsoft Excel le permite administrar las propiedades del documento de los archivos de Excel de manera WYSIWYG. Siga los pasos a continuación para abrir elPropiedades cuadro de diálogo en Excel 2016.

Desde elArchivo menú, seleccione Información*.

Selección del menú Información

Haga clic enPropiedades encabezado y seleccione “Propiedades avanzadas”.

Al hacer clic en Selección de propiedades avanzadas

Administre las propiedades del documento del archivo.

Diálogo de propiedades

En el cuadro de diálogo Propiedades, hay diferentes pestañas, como General, Resumen, Estadísticas, Contenido y Aduanas. Cada pestaña ayuda a configurar diferentes tipos de información relacionada con el archivo. La pestaña Personalizado se utiliza para administrar propiedades personalizadas.

Cómo trabajar con propiedades de documentos usando Aspose.Cells

Los desarrolladores pueden administrar dinámicamente las propiedades del documento utilizando las API Aspose.Cells. Esta característica ayuda a los desarrolladores a almacenar información útil junto con el archivo, como cuándo se recibió, procesó, con marca de tiempo, etc.

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 el documento en PDF, Aspose.Cells for .NET completaSolicitud campo con valor ‘Aspose.Cells’ yPDF Productor campo con el valor, por ejemplo, ‘Aspose.Cells v17.9’.

Tenga en cuenta que no puede indicarle 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

Aspose.Cells Las API admiten ambos tipos de propiedades de documento, integradas y personalizadas. Aspose.Cells'Libro de trabajo La clase representa un archivo de Excel y, como un archivo de Excel, elLibro de trabajo La clase puede contener varias hojas de trabajo, cada una representada por elHoja de cálculo clase, mientras que la colección de hojas de trabajo está representada porColección de hojas de trabajoclase.

Utilizar elColección de hojas de trabajopara acceder a las propiedades del documento del archivo como se describe a continuación.

Para acceder a las propiedades integradas del documento, utiliceColección de hojas de trabajo.BuiltInDocumentProperties.
Para acceder a las propiedades personalizadas del documento, utiliceWorksheetCollection.CustomDocumentProperties.

AmbosColección de hojas de trabajo.BuiltInDocumentProperties yWorksheetCollection.CustomDocumentProperties devolver la instancia deAspose.Cells.Properties.DocumentPropertyCollection. Esta colección contieneAspose.Cells.Properties.DocumentPropertyobjetos, cada uno de los cuales representa una única propiedad de documento integrada o personalizada.

Depende del requisito de la solicitud cómo acceder a una propiedad, es decir; utilizando el índice o nombre de la propiedad delColección de propiedades del documentocomo se demuestra en el siguiente ejemplo.

ElAspose.Cells.Properties.DocumentPropertyLa clase permite recuperar el nombre, valor y tipo de la propiedad del documento:

Para obtener el nombre de la propiedad, utilicePropiedadDocumento.Nombre.
Para obtener el valor de la propiedad, usePropiedad del documento.Valor. Propiedad del documento.Valordevuelve el valor como un Objeto.
Para obtener el tipo de propiedad, utilicePropiedadDeDocumento.Tipo . Esto devuelve uno de losTipo de propiedadvalores de enumeración. Después de obtener el tipo de propiedad, utilice uno de losPropiedadDeDocumento.ToXXX métodos para obtener el valor del tipo apropiado en lugar de utilizarPropiedad del documento.Valor . ElPropiedadDeDocumento.ToXXXLos métodos se describen en la siguiente tabla.

ElPropiedad del documentoLa clase 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
Booleano	El tipo de datos de la propiedad es booleano.	ParaBool
Fecha	El tipo de datos de la propiedad es DateTime. Tenga en cuenta que Microsoft Excel sólo almacena la parte de la fecha, no se puede almacenar ninguna hora en una propiedad personalizada de este tipo	Hasta fecha y hora
Flotar	El tipo de datos de la propiedad es Doble	Para duplicar
Número	El tipo de datos de la propiedad es Int32.	ToInt
String	El tipo de datos de la propiedad es String	Encadenar

Cómo agregar o eliminar propiedades de documentos personalizados

Como describimos anteriormente al comienzo de este tema, los desarrolladores no pueden agregar ni eliminar propiedades integradas porque están definidas por el sistema, pero es posible agregar o eliminar propiedades personalizadas porque están definidas por el usuario.

Cómo agregar propiedades personalizadas

Aspose.Cells Las API han expuesto elAgregar método para elColección de propiedades de documentos personalizados clase para agregar propiedades personalizadas a la colección. ElAgregar El método agrega la propiedad al archivo de Excel y devuelve una referencia para la nueva propiedad del documento como unAspose.Cells.Properties.DocumentPropertyobjeto.

Cómo configurar la propiedad personalizada “Enlace al contenido”

Para crear una propiedad personalizada vinculada al contenido de un rango determinado, llame alCustomDocumentPropertyCollection.AddLinkToContent método y pase el nombre de la propiedad y la fuente. Puede verificar si una propiedad está configurada como vinculada al contenido usando elPropiedadDeDocumento.IsLinkedToContent propiedad. Además, también es posible obtener el rango de fuente utilizando elFuente propiedad de laPropiedad del documentoclase.

Usamos una plantilla simple Microsoft archivo Excel en el ejemplo. El libro tiene un rango con nombre definido etiquetadoMi gama que se refiere a un valor de celda.

Cómo eliminar propiedades personalizadas

Para eliminar propiedades personalizadas usando Aspose.Cells, llame alDocumentPropertyCollection.Eliminarmétodo y pase el nombre de la propiedad del documento que se eliminará.

Temas avanzados

Imprimir y obtener una vista previa del libro de trabajo Administre hojas de trabajo de Microsoft archivos de Excel.