Trabajar con hojas de trabajo GridWeb

Acceder a hojas de trabajo

En este tema se analiza el acceso a las hojas de trabajo del control GridWeb. También podemos llamar a estas hojas de trabajo hojas de trabajo web porque pertenecen a GridWeb y se utilizan en aplicaciones web.

Todas las hojas de trabajo contenidas en el control GridWeb se almacenan en una GridWorksheetCollection del control GridWeb. Es sencillo acceder a una hoja de trabajo en particular mediante su índice de hoja.

Los desarrolladores pueden acceder a una hoja de trabajo específica especificando su índice de hoja como se muestra a continuación en el fragmento de código de ejemplo.

Eliminar una hoja de trabajo

Este tema proporciona información breve sobre cómo eliminar hojas de cálculo de archivos Excel Microsoft utilizando GridWeb API. Elimine una hoja de cálculo especificando su índice de hoja.

Los desarrolladores pueden eliminar una hoja de trabajo específica especificando su índice de hoja usando el método removeAt de la colección GridWorksheetCollection, como se muestra a continuación en el fragmento de código de ejemplo.

Agregar hojas de trabajo

Las hojas de trabajo son una parte integral de GridWeb. Todos los datos se gestionan y almacenan en forma de hojas de trabajo. GridWeb permite a los desarrolladores agregar una o más hojas de trabajo al control Aspose.Cells.GridWeb. Este tema muestra enfoques simples para agregar hojas de trabajo a GridWeb.

Sin especificar el nombre de la hoja

La forma más sencilla de agregar una hoja de trabajo a Aspose.Cells.GridWeb es llamar al método add de la clase GridWorksheetCollection en el control GridWeb. Esto crea hojas de trabajo que usan nombres predeterminados (es decir, Hoja1, Hoja2, Hoja3, etc.) y las agrega al control GridWeb.

Salida: se ha agregado una hoja de trabajo con nombre predeterminado a GridWeb

todo:image_alt_text

Con nombre de hoja especificado

Para agregar una hoja de cálculo con un nombre específico al control GridWeb en lugar de usar el esquema de nomenclatura predeterminado, llame a una versión sobrecargada del método add que toma la cadena SheetName especificada. Por ejemplo, el siguiente ejemplo agrega una hoja de trabajo llamada Factura.

Salida: se ha agregado una hoja de trabajo con un nombre específico a GridWeb

todo:image_alt_text

Cambiar el nombre de una hoja de trabajo

Cambiar el nombre de una hoja de trabajo puede resultar muy útil cuando se trabaja con muchas hojas de trabajo en GridWeb y se decide cambiar sus nombres para hacerlas más significativas. Por ejemplo, se puede cambiar el nombre de una hoja de trabajo que contiene una factura a Factura en lugar de Hoja1. Este tema describe esta característica simple pero útil.

Cambiar el nombre de una hoja de trabajo

Todas las hojas de trabajo contienen una propiedad Nombre que permite a los desarrolladores acceder o modificar los nombres de las hojas de trabajo. Para cambiar el nombre de una hoja de trabajo:

  1. Acceda a una hoja de trabajo desde GridWorksheetCollection.
  2. Cambie el nombre de la hoja de trabajo seleccionada.

Antes de ejecutar el código, la hoja de trabajo tiene un nombre predeterminado, como Hoja1.

Archivo de entrada: una hoja de trabajo con un nombre predeterminado Hoja1

todo:image_alt_text

Después de ejecutar el código, la hoja de trabajo pasa a llamarse Factura.

Salida: la hoja de trabajo pasa a llamarse Factura

todo:image_alt_text

Copiar una hoja de trabajo

Agregar hojas de trabajodescribe cómo agregar nuevas hojas de trabajo a GridWeb. También es posible agregar una copia (o réplica) de otra hoja de trabajo al control Aspose.Cells.GridWeb. Esta característica puede resultar útil cuando datos idénticos o similares en una hoja de trabajo también se requieren en otra hoja de trabajo. Cuando ese es el caso, es más fácil copiar una hoja de trabajo existente y agregarla a Aspose.Cells.GridWeb como una nueva hoja de trabajo en lugar de crearla desde cero.

Usando el índice de hojas

El siguiente código de ejemplo muestra cómo agregar una copia de una hoja de trabajo al control GridWeb especificando el índice de la hoja de trabajo en el método addCopy de GridWorksheetCollection.

Usando el nombre de la hoja

El siguiente código de ejemplo muestra cómo agregar una copia de una hoja de trabajo al control GridWeb especificando el nombre de la hoja de trabajo en el método addCopy de GridWorksheetCollection.

Trabajar con rangos con nombre

Normalmente, las etiquetas de columnas y filas se utilizan para hacer referencia única a las celdas. Pero puedes crear nombres descriptivos para representar celdas, rangos de celdas, fórmulas o valores constantes.

La palabranombre puede referirse a una cadena de caracteres que representa una celda, un rango de celdas, una fórmula o un valor constante. Por ejemplo, utilice nombres fáciles de entender, como Productos, para referirse a rangos difíciles de entender, como Ventas!C20:C30.

Las etiquetas se pueden utilizar en fórmulas que hacen referencia a datos de la misma hoja de cálculo; Si desea representar un rango en otra hoja de trabajo, puede usar un nombre.rangos con nombre es una de las características más poderosas de Microsoft Excel.

Los usuarios pueden asignar un nombre a un rango y usar ese nombre en fórmulas. Aspose.Cells.GridWeb admite esta función.

Agregar/hacer referencia a rangos con nombre en fórmulas

El control GridWeb proporciona dos clases (GridName y GridNameCollection) para trabajar con rangos con nombre.

El siguiente fragmento de código le ayudará a comprender cómo utilizarlos.

Administrar comentarios en la hoja de trabajo

Este tema trata sobre cómo agregar, acceder y eliminar comentarios de las hojas de trabajo. Los comentarios son útiles para agregar notas o información útil para los usuarios que trabajarán con la hoja. Los desarrolladores tienen la flexibilidad de agregar comentarios a cualquier celda de la hoja de trabajo.

Trabajar con comentarios

Agregar comentarios

Para agregar un comentario a la hoja de trabajo, siga los pasos a continuación:

  1. Agregue el control Aspose.Cells.GridWeb al formulario web.
  2. Acceda a la hoja de trabajo a la que está agregando comentarios.
  3. Añade un comentario a una celda.
  4. Establezca una nota para el nuevo comentario.

Se ha añadido un comentario a la hoja de trabajo.

todo:image_alt_text

Accediendo a comentarios

Para acceder a un comentario:

  1. Accede a la celda que contiene el comentario.
  2. Obtenga la referencia de la celda.
  3. Pase la referencia a la colección de comentarios para acceder al comentario.
  4. Ahora es posible modificar las propiedades del comentario.

Eliminar comentarios

Para eliminar un comentario:

  1. Accede a la celda como se explicó anteriormente.
  2. Utilice el método removeAt de la colección de comentarios para eliminar el comentario.

Administrar hipervínculos en la hoja de trabajo

Este tema analiza qué tipos de hipervínculos se admiten en Aspose.Cells.GridWeb y cómo administrarlos mediante programación. Los hipervínculos se pueden utilizar para crear enlaces a URL web o para realizar una devolución de datos a un servidor.

Tipos de hipervínculos

Aspose.Cells.GridWeb admite los siguientes hipervínculos:

  • Hipervínculos URL de texto, hipervínculos URL aplicados al texto.
  • Hipervínculos URL de imágenes, hipervínculos URL aplicados a imágenes.

Hipervínculos URL de texto

El siguiente ejemplo agrega dos hipervínculos a una hoja de trabajo. Uno tiene un objetivo _en blanco mientras que el otro está configurado como _parent.

todo:image_alt_text

Salida: hipervínculos de texto agregados a la hoja de trabajo

Hipervínculos URL de imágenes

El siguiente ejemplo agrega un hipervínculo URL de imagen a una hoja de trabajo.

todo:image_alt_text

Salida: hipervínculo de imagen agregado a la hoja de trabajo

Ordenar datos

La clasificación es una característica muy valiosa cuando se trata de procesamiento de datos. Los datos sin clasificar son una molestia para los usuarios cuando buscan información específica. Aspose.Cells.GridWeb admite potentes funciones de clasificación. En este tema se analiza la clasificación de datos utilizando Aspose.Cells.GridWeb API.

Aspose.Cells.GridWeb permite a los desarrolladores ordenar datos horizontal y verticalmente para que puedan ordenar datos de arriba a abajo o de izquierda a derecha.

De arriba a abajo

Para ordenar datos de arriba a abajo:

  1. Agregue el control Aspose.Cells.GridWeb a su formulario web.
  2. Accede a la hoja de trabajo que deseas ordenar.
  3. Ordene el rango de datos en cualquier orden (ascendente o descendente). Asegúrese de seleccionar la orientación de arriba a abajo.

El siguiente ejemplo ordena los datos en dos columnas (ID del estudiante y Nombre del estudiante) de una hoja de trabajo en orden ascendente. Sólo doce filas de dos columnas están ordenadas de arriba a abajo.

Antes de aplicar el código, la hoja de trabajo contiene datos desordenados.

Entrada: datos sin clasificar

todo:image_alt_text

Después de ejecutar el código, los datos se ordenan en orden ascendente.

Salida: datos ordenados de arriba a abajo en orden ascendente

todo:image_alt_text

De izquierda a derecha

Para ordenar datos de izquierda a derecha:

  1. Agregue el control Aspose.Cells.GridWeb a su formulario web.
  2. Accede a la hoja de trabajo que deseas ordenar.
  3. Ordene el rango de datos en cualquier orden (ascendente o descendente). Asegúrese de seleccionar de izquierda a derecha.

El siguiente ejemplo ordena los datos en dos filas (ID del estudiante y Nombre del estudiante) en orden ascendente. Sólo dos filas de cuatro columnas están ordenadas de izquierda a derecha.

Antes de aplicar el código, la hoja de trabajo contiene datos desordenados.

Entrada: datos sin ordenar antes de ejecutar el fragmento de código

todo:image_alt_text

Después de ejecutar el código, los datos se ordenan en orden ascendente.

Salida: datos ordenados de izquierda a derecha en orden ascendente

todo:image_alt_text

Buscando y reemplazando

Una de las formas más rápidas de realizar cambios repetitivos en una hoja de cálculo grande es utilizar la función de buscar y reemplazar. Buscar le ayuda a localizar una cadena de texto o datos y reemplazarlos por un nuevo valor. Aspose.Cells.GridWeb proporciona esta función. Le permite buscar y reemplazar con una cadena de texto o valor específico en la hoja de trabajo del lado del cliente a través de un cuadro de diálogo simple. Incluso te permite buscar datos parciales.

El cuadro de diálogo Buscar/Reemplazar

Hay dos formas de abrir el cuadro de diálogo Buscar/Reemplazar:

  1. Cuando el control esté activo, presioneCTRL+F para abrir el cuadro de diálogo, o presioneCTRL+R tecla para abrir el diálogo con elReemplazar botón habilitado.
  2. Mueva el cursor al área de la celda en la hoja de trabajo y luego haga clic derecho. SeleccionarEncontrar oReemplazar desde el menú.

Seleccionando Buscar

todo:image_alt_text

Se muestra un cuadro de diálogo de buscar y reemplazar.

El cuadro de diálogo Buscar/Reemplazar

todo:image_alt_text

Usando buscar

Buscar:

  1. Abra el cuadro de diálogo Buscar/Reemplazar.
  2. Escriba la cadena que desea buscar en el campo Buscar.
  3. Haga clic en Buscar siguiente para buscar.

Se resalta la siguiente celda que coincide con su condición de búsqueda.

Opciones de búsqueda

Hay algunas opciones de búsqueda que puede personalizar en el cuadro de diálogo. La siguiente tabla los enumera.

No. Nombre de la opción Descripción
1 caso de partido Indica si se debe utilizar la distinción entre mayúsculas y minúsculas en la búsqueda.
2 Compare la palabra completa Indica si se debe buscar la palabra completa en la búsqueda.
3 buscar Indica si la búsqueda se realizará de abajo hacia arriba.
4 Expresión regular Cuando está marcado, el control tratará la cadena en el cuadro de texto Buscar como una expresión regular en el proceso de búsqueda.
5 Buscar en Fórmulas/Valores Cuando se selecciona Fórmulas, el control coincidirá con la fórmula o el valor sin formato de las celdas si la fórmula o el valor sin formato está presente. Cuando se selecciona Valores, el control solo coincidirá con el valor mostrado de las celdas.

Usando Reemplazar

Para reemplazar texto o valores:

  1. Abra el cuadro de diálogo Buscar/Reemplazar presionandoCTRL+F, o seleccione, haga clic con el botón derecho en una celda y seleccione Buscar antes de hacer clic en Reemplazar*.
  2. Escriba la cadena de reemplazo en elReemplazar concampo.
  3. Haga clic en Reemplazar*.

Para reemplazar texto:

  1. Abra el cuadro de diálogo.
  2. Introduzca el texto que desea encontrar en elEncontrar que campo y el texto que desea reemplazar dentro delReemplazar con campo.
  3. Reemplace una ocurrencia a la vez haciendo clicBuscar siguiente seguido de Reemplazar*.
  4. Si está muy seguro de lo que contiene la hoja de trabajo, haga clic en Reemplazar todo*.

Agregar/eliminar hipervínculos del lado del cliente

Aspose.Cells GridWeb ahora admite agregar y eliminar hipervínculos desde el lado del cliente. Para ello, el API dispone de las funciones “addCelllink” y “delCelllink”. Los siguientes fragmentos de código demuestran cómo agregar y eliminar hipervínculos desde el lado del cliente en GridWeb.

Código de muestra

También puede vincular a la hoja utilizando el siguiente fragmento de código.

Actualizar la configuración de fuentes desde el lado del cliente

Aspose.Cells GridWeb ahora admite cambiar la configuración de fuente desde el lado del cliente. Para ello, el API proporciona las siguientes funciones

  • updateCellFontStyle*: Parámetros - r/i/b/ib para regular/cursiva/negrita/cursiva&&bold
  • updateCellFontSize*: Parámetros - nombre de fuente, etc. ‘Sistema’
  • updateCellFontName*: Parámetros: tamaño de fuente, etc. ‘12 puntos’
  • updateCellFontColor*: Parámetros: ninguno/u/l/ul/ para ninguno/subrayado/tachado/subrayado&&tachado
  • updateCellFontLine*: Parámetros: color html como #aa22ee o nombre de color conocido como verde, rojo,…
  • updateCellBackGroundColor*: Parámetros: color html como #aa22ee o nombre de color conocido como verde, rojo,…

El siguiente fragmento de código demuestra cómo cambiar la configuración de fuente desde el lado del cliente en GridWeb.

Código de muestra

Agregar/eliminar comentarios del lado del cliente

Aspose.Cells GridWeb ahora admite agregar y eliminar comentarios del lado del cliente. Para ello, el API proporciona las funciones “añadir comentarios” y “eliminar comentarios”. El siguiente fragmento de código muestra cómo agregar y eliminar comentarios del lado del cliente en GridWeb.

Código de muestra

Mostrar botones para agregar o quitar hojas de trabajo

Aspose.Cells GridWeb ahora admite agregar y eliminar hojas mediante botones en la barra de herramientas. Para que los botones sean visibles en la interfaz, debe configurarGridWeb1.ShowAddButton a verdadero*. El siguiente fragmento de código demuestra cómo agregar o quitar botones a la barra de herramientas de GridWeb.

Código de muestra