Administrar propiedades de documentos

Introducción

Microsoft Excel ofrece la posibilidad de agregar propiedades a los archivos de hojas de cálculo. Estas propiedades del documento brindan 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 acerca de las propiedades integradas y personalizadas es que se puede acceder a las propiedades integradas y modificarlas, pero no crearlas ni eliminarlas. Sin embargo, las propiedades personalizadas se pueden crear y administrar.

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ú, seleccioneInformación.

Selección del menú de información

Haga clic enPropiedadesencabezado y seleccione “Propiedades avanzadas”.

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 las propiedades personalizadas.

Trabajar con propiedades de documentos usando Aspose.Cells

Los desarrolladores pueden administrar dinámicamente las propiedades del documento utilizando las API Aspose.Cells. Esta función ayuda a los desarrolladores a almacenar información útil junto con el archivo, como cuándo se recibió, procesó, marcó la hora, 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 renderizar Documento a PDF, Aspose.Cells for .NET se rellenaSolicitud campo con valor ‘Aspose.Cells’ yPDF Productor campo con el valor, por ejemplo, ‘Aspose.Cells v17.9’.

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

Acceso a las propiedades del documento

Aspose.Cells Las API admiten ambos tipos de propiedades de documentos, integradas y personalizadas. Aspose.Cells'Libro de trabajo 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 mientras que la colección de hojas de trabajo está representada por elColecció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 del documento incorporado, utiliceWorksheetCollection.BuiltInDocumentProperties.
Para acceder a las propiedades del documento personalizado, utiliceWorksheetCollection.CustomDocumentProperties.

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

Queda a criterio de la solicitud cómo acceder a un inmueble, es decir; utilizando el índice o el nombre de la propiedad de laDocumentPropertyCollectioncomo se demuestra en el siguiente ejemplo.

ÉlAspose.Cells.Properties.DocumentPropertyclass permite recuperar el nombre, valor y tipo de la propiedad del documento:

Para obtener el nombre de la propiedad, utiliceDocumentoPropiedad.Nombre.
Para obtener el valor de la propiedad, utiliceDocumentoPropiedad.Valor. DocumentoPropiedad.Valordevuelve el valor como un objeto.
Para obtener el tipo de propiedad, useDocumentProperty.Type . Esto devuelve uno de losTipo de propiedad valores de enumeración. Después de obtener el tipo de propiedad, utilice uno de losPropiedadDocumento.ToXXX métodos para obtener el valor del tipo apropiado en lugar de utilizarDocumentoPropiedad.Valor . ÉlPropiedadDocumento.ToXXXLos métodos se describen en la siguiente tabla.

ÉlDocumentoPropiedadclass 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.	ToBool
Fecha	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	HastaFechaHora
Flotar	El tipo de datos de la propiedad es Doble	Para duplicar
Número	El tipo de datos de propiedad es Int32	ToInt
Cadena	El tipo de datos de la propiedad es String	Encadenar

Adición o eliminación de propiedades de documentos personalizados

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

Adición de propiedades personalizadas

Aspose.Cells Las API han expuesto elAgregar método para elCustomDocumentPropertyCollection class para agregar propiedades personalizadas a la colección. ÉlAgregar El método agrega la propiedad al archivo de Excel y devuelve una referencia para la propiedad del nuevo documento como unAspose.Cells.Properties.DocumentPropertyobjeto.

Configuración de 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 comprobar si una propiedad está configurada como vinculada a contenido utilizando elDocumentProperty.IsLinkedToContent propiedad. Además, también es posible obtener el rango de fuente usando elFuente propiedad de laDocumentoPropiedadclase.

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

Eliminación de propiedades personalizadas

Para eliminar propiedades personalizadas usando Aspose.Cells, llame alDocumentPropertyCollection.Removey 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.