Travailler avec des feuilles de calcul GridWeb

Accéder aux feuilles de calcul

Cette rubrique traite de l’accès aux feuilles de calcul du contrôle GridWeb. Nous pouvons également appeler ces feuilles de calcul feuilles de calcul Web car elles appartiennent à GridWeb et sont utilisées dans les applications Web.

Toutes les feuilles de calcul contenues dans le contrôle GridWeb sont stockées dans un GridWorksheetCollection du contrôle GridWeb. Il est simple d’accéder à une feuille de calcul particulière grâce à son index de feuille.

Les développeurs peuvent accéder à une feuille de calcul spécifique en spécifiant son index de feuille, comme illustré ci-dessous dans l’exemple d’extrait de code.

Supprimer une feuille de calcul

Cette rubrique fournit de brèves informations sur la suppression de feuilles de calcul des fichiers Excel Microsoft à l’aide de GridWeb API. Supprimez une feuille de calcul en spécifiant son index de feuille.

Les développeurs peuvent supprimer une feuille de calcul spécifique en spécifiant son index de feuille à l’aide de la méthode removeAt de la collection GridWorksheetCollection, comme illustré ci-dessous dans l’exemple d’extrait de code.

Ajout de feuilles de calcul

Les feuilles de calcul font partie intégrante de GridWeb. Toutes les données sont gérées et stockées sous forme de feuilles de calcul. GridWeb permet aux développeurs d’ajouter une ou plusieurs feuilles de calcul au contrôle Aspose.Cells.GridWeb. Cette rubrique présente des approches simples pour ajouter des feuilles de calcul à GridWeb.

Sans spécifier le nom de la feuille

Le moyen le plus simple d’ajouter une feuille de calcul à Aspose.Cells.GridWeb consiste à appeler la méthode add de la classe GridWorksheetCollection dans le contrôle GridWeb. Cela crée des feuilles de calcul qui utilisent des noms par défaut (c’est-à-dire Sheet1, Sheet2, Sheet3, etc.) et les ajoute au contrôle GridWeb.

Résultat : une feuille de calcul avec un nom par défaut a été ajoutée à GridWeb

tâche : image_alt_text

Avec le nom de feuille spécifié

Pour ajouter une feuille de calcul avec un nom spécifique au contrôle GridWeb au lieu d’utiliser le schéma de dénomination par défaut, appelez une version surchargée de la méthode add qui prend la chaîne SheetName spécifiée. Par exemple, l’exemple ci-dessous ajoute une feuille de calcul nommée Facture.

Résultat : une feuille de calcul avec un nom spécifié a été ajoutée à GridWeb

tâche : image_alt_text

Renommer une feuille de calcul

Renommer une feuille de calcul peut être très utile lorsque vous travaillez avec de nombreuses feuilles de calcul dans GridWeb et décidez de modifier leurs noms pour les rendre plus significatives. Par exemple, une feuille de calcul contenant une facture peut être renommée Facture au lieu de Feuille1. Cette rubrique décrit cette fonctionnalité simple mais utile.

Renommer une feuille de calcul

Toutes les feuilles de calcul contiennent une propriété Name qui permet aux développeurs d’accéder ou de modifier les noms des feuilles de calcul. Pour renommer une feuille de calcul :

  1. Accédez à une feuille de calcul à partir de GridWorksheetCollection.
  2. Renommez la feuille de calcul sélectionnée.

Avant d’exécuter le code, la feuille de calcul porte un nom par défaut, tel que Sheet1.

Fichier d’entrée : une feuille de calcul avec un nom par défaut Sheet1

tâche : image_alt_text

Après avoir exécuté le code, la feuille de calcul est renommée Facture.

Résultat : la feuille de calcul est renommée Facture

tâche : image_alt_text

Copier une feuille de calcul

Ajout de feuilles de calculdécrit comment ajouter de nouvelles feuilles de calcul à GridWeb. Il est également possible d’ajouter une copie (ou une réplique) d’une autre feuille de calcul au contrôle Aspose.Cells.GridWeb. Cette fonctionnalité peut être utile lorsque des données identiques ou similaires dans une feuille de calcul sont également requises dans une autre feuille de calcul. Lorsque tel est le cas, il est plus facile de copier une feuille de calcul existante et de l’ajouter à Aspose.Cells.GridWeb en tant que nouvelle feuille de calcul au lieu de la créer à partir de zéro.

Utilisation de l’index de feuille

L’exemple de code ci-dessous montre comment ajouter une copie d’une feuille de calcul au contrôle GridWeb en spécifiant l’index de la feuille de calcul dans la méthode addCopy de GridWorksheetCollection.

Utiliser le nom de la feuille

L’exemple de code ci-dessous montre comment ajouter une copie d’une feuille de calcul au contrôle GridWeb en spécifiant le nom de la feuille de calcul dans la méthode addCopy de GridWorksheetCollection.

Travailler avec des plages nommées

Normalement, les étiquettes de colonne et de ligne sont utilisées pour faire référence de manière unique aux cellules. Mais vous pouvez créer des noms descriptifs pour représenter des cellules, des plages de cellules, des formules ou des valeurs constantes.

Le motnom peut faire référence à une chaîne de caractères qui représente une cellule, une plage de cellules, une formule ou une valeur constante. Par exemple, utilisez des noms faciles à comprendre, tels que Produits, pour faire référence à des plages difficiles à comprendre, telles que Sales!C20:C30.

Les étiquettes peuvent être utilisées dans des formules faisant référence à des données sur la même feuille de calcul ; si vous souhaitez représenter une plage sur une autre feuille de calcul, vous pouvez utiliser un nom.Plages nommées est l’une des fonctionnalités les plus puissantes de Microsoft Excel.

Les utilisateurs peuvent attribuer un nom à une plage et utiliser ce nom dans les formules. Aspose.Cells.GridWeb prend en charge cette fonctionnalité.

Ajout/référencement de plages nommées dans les formules

Le contrôle GridWeb fournit deux classes (GridName et GridNameCollection) pour travailler avec des plages nommées.

L’extrait de code suivant vous aidera à comprendre comment les utiliser.

Gestion des commentaires dans la feuille de calcul

Cette rubrique traite de l’ajout, de l’accès et de la suppression de commentaires dans des feuilles de calcul. Les commentaires sont utiles pour ajouter des notes ou des informations utiles aux utilisateurs qui travailleront avec la feuille. Les développeurs ont la possibilité d’ajouter des commentaires à n’importe quelle cellule de la feuille de calcul.

Travailler avec des commentaires

Ajouter des commentaires

Pour ajouter un commentaire à la feuille de calcul, veuillez suivre les étapes ci-dessous :

  1. Ajoutez le contrôle Aspose.Cells.GridWeb au formulaire Web.
  2. Accédez à la feuille de calcul à laquelle vous ajoutez des commentaires.
  3. Ajouter un commentaire à une cellule.
  4. Définissez une note pour le nouveau commentaire.

Un commentaire a été ajouté à la feuille de calcul

tâche : image_alt_text

Accéder aux commentaires

Pour accéder à un commentaire :

  1. Accédez à la cellule qui contient le commentaire.
  2. Obtenez la référence de la cellule.
  3. Passez la référence à la collection Comment pour accéder au commentaire.
  4. Il est désormais possible de modifier les propriétés du commentaire.

Supprimer des commentaires

Pour supprimer un commentaire :

  1. Accédez à la cellule comme expliqué ci-dessus.
  2. Utilisez la méthode RemoveAt de la collection Comment pour supprimer le commentaire.

Gestion des hyperliens dans la feuille de calcul

Cette rubrique explique quels types de liens hypertexte sont pris en charge dans Aspose.Cells.GridWeb et comment les gérer par programme. Les hyperliens peuvent être utilisés soit pour créer des liens vers des URL Web, soit pour effectuer une publication sur un serveur.

Types d’hyperliens

Les hyperliens suivants sont pris en charge par Aspose.Cells.GridWeb :

  • Hyperliens URL de texte, hyperliens URL appliqués au texte.
  • Hyperliens URL d’image, hyperliens URL appliqués aux images.

Liens hypertexte URL texte

L’exemple ci-dessous ajoute deux hyperliens à une feuille de calcul. L’un a une cible _blank tandis que l’autre est défini sur _parent.

tâche : image_alt_text

Résultat : liens hypertextes textuels ajoutés à la feuille de calcul

Liens hypertextes URL des images

L’exemple ci-dessous ajoute un lien hypertexte URL d’image à une feuille de calcul.

tâche : image_alt_text

Résultat : lien hypertexte d’image ajouté à la feuille de calcul

Tri des données

Le tri est une fonctionnalité très précieuse en matière de traitement des données. Les données non triées sont pénibles pour les utilisateurs lorsqu’ils recherchent des informations spécifiques. Aspose.Cells.GridWeb prend en charge de puissantes fonctionnalités de tri. Cette rubrique traite du tri des données à l’aide de Aspose.Cells.GridWeb API.

Aspose.Cells.GridWeb permet aux développeurs de trier les données horizontalement et verticalement afin que les développeurs puissent trier les données de haut en bas ou de gauche à droite.

Du haut jusqu’en bas

Pour trier les données de haut en bas :

  1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
  2. Accédez à la feuille de calcul que vous souhaitez trier.
  3. Triez la plage de données dans n’importe quel ordre (croissant ou décroissant). Assurez-vous de sélectionner l’orientation de haut en bas.

L’exemple ci-dessous trie les données dans deux colonnes (ID d’étudiant et nom de l’étudiant) d’une feuille de calcul par ordre croissant. Seules douze lignes de deux colonnes sont triées de haut en bas.

Avant d’appliquer le code, la feuille de calcul contient des données non ordonnées.

Entrée : données non triées

tâche : image_alt_text

Après avoir exécuté le code, les données sont triées par ordre croissant.

Sortie : données triées de haut en bas par ordre croissant

tâche : image_alt_text

De gauche à droite

Pour trier les données de gauche à droite :

  1. Ajoutez le contrôle Aspose.Cells.GridWeb à votre formulaire Web.
  2. Accédez à la feuille de calcul que vous souhaitez trier.
  3. Triez la plage de données dans n’importe quel ordre (croissant ou décroissant). Assurez-vous de sélectionner de gauche à droite.

L’exemple ci-dessous trie les données sur deux lignes (ID d’étudiant et nom de l’étudiant) par ordre croissant. Seules deux lignes de quatre colonnes sont triées de gauche à droite.

Avant d’appliquer le code, la feuille de calcul contient des données non ordonnées.

Entrée : données non triées avant l’exécution de l’extrait de code

tâche : image_alt_text

Après avoir exécuté le code, les données sont triées par ordre croissant.

Sortie : données triées de gauche à droite par ordre croissant

tâche : image_alt_text

Rechercher et remplacer

L’un des moyens les plus rapides d’apporter des modifications répétitives dans une grande feuille de calcul consiste à utiliser la fonction Rechercher et remplacer. Rechercher vous aide à localiser une chaîne de texte ou des données et à la remplacer par une nouvelle valeur. Aspose.Cells.GridWeb fournit cette fonctionnalité. Il vous permet de rechercher et de remplacer par une chaîne de texte ou une valeur spécifique dans la feuille de calcul côté client via une simple boîte de dialogue. Il vous permet même de rechercher des données partielles.

La boîte de dialogue Rechercher/Remplacer

Il existe deux manières d’ouvrir la boîte de dialogue Rechercher/Remplacer :

  1. Lorsque le contrôle est actif, appuyez surCTRL+F pour ouvrir la boîte de dialogue, ou appuyez surCTRL+R touche pour ouvrir la boîte de dialogue avec leRemplacer bouton activé.
  2. Déplacez le curseur vers la zone de cellule de la feuille de calcul, puis cliquez avec le bouton droit. SélectionnerTrouver ouRemplacer du menu.

Sélection de Rechercher

tâche : image_alt_text

Une boîte de dialogue Rechercher et remplacer s’affiche.

La boîte de dialogue Rechercher/Remplacer

tâche : image_alt_text

Utiliser Rechercher

Chercher:

  1. Ouvrez la boîte de dialogue Rechercher/Remplacer.
  2. Tapez la chaîne que vous souhaitez rechercher dans le champ Rechercher.
  3. Cliquez sur Rechercher suivant pour lancer la recherche.

La cellule suivante qui correspond à votre condition de recherche est mise en surbrillance.

Options de recherche

Certaines options de recherche peuvent être personnalisées dans la boîte de dialogue. Le tableau ci-dessous les répertorie.

Non. Nom de l’option Description
1 Cas de correspondance Indique s’il faut utiliser la casse dans la recherche.
2 Correspond à un mot entier Indique s’il faut faire correspondre le mot entier lors de la recherche.
3 Rechercher Indique si la recherche se fera de bas en haut.
4 Expression régulière Lorsque cette case est cochée, le contrôle traitera la chaîne dans la zone de texte Rechercher comme une expression régulière dans le processus de recherche.
5 Rechercher dans les formules/valeurs Lorsque les formules sont sélectionnées, le contrôle correspondra à la formule ou à la valeur non formatée des cellules si la formule ou la valeur non formatée est présente. Lorsque les valeurs sont sélectionnées, le contrôle correspondra uniquement à la valeur affichée des cellules.

Utiliser Remplacer

Pour remplacer du texte ou des valeurs :

  1. Ouvrez la boîte de dialogue Rechercher/Remplacer en appuyant surCTRL+F, ou sélectionnez cliquez avec le bouton droit sur une cellule et sélectionnez Rechercher avant de cliquer sur Remplacer*.
  2. Tapez la chaîne de remplacement dans le champRemplacer parchamp.
  3. Cliquez sur Remplacer*.

Pour remplacer du texte :

  1. Ouvrez la boîte de dialogue.
  2. Saisissez le texte que vous souhaitez rechercher dans leTrouver quoi champ et le texte que vous souhaitez remplacer dans le champRemplacer par champ.
  3. Remplacez une occurrence à la fois en cliquant surRechercher suivant suivi de Remplacer*.
  4. Si vous êtes sûr de ce que contient la feuille de calcul, cliquez sur Remplacer tout*.

Ajouter/Supprimer des hyperliens du côté client

Aspose.Cells GridWeb prend désormais en charge l’ajout et la suppression d’hyperliens côté client. Pour cela, le API met à disposition les fonctions “addCelllink” et “delCelllink”. Les extraits de code suivants illustrent l’ajout et la suppression de liens hypertexte du côté client dans GridWeb.

Exemple de code

Vous pouvez également créer un lien vers la feuille à l’aide de l’extrait de code suivant.

Mettre à jour les paramètres de police du côté client

Aspose.Cells GridWeb prend désormais en charge la modification des paramètres de police du côté client. Pour cela, le API propose les fonctions suivantes

  • updateCellFontStyle* : Params - r/i/b/ib pour régulier/italique/bold/italique&&bold
  • updateCellFontSize* : Params - nom de la police, etc. ‘Système’
  • updateCellFontName* : Params - taille de la police, etc. ‘12pts’
  • updateCellFontColor* : Params - none/u/l/ul/ pour none/underline/strikeout/underline&&strikeout
  • updateCellFontLine* : Params - couleur HTML comme #aa22ee ou nom de couleur bien connu comme vert, rouge,…
  • updateCellBackGroundColor* : Params - couleur HTML comme #aa22ee ou nom de couleur bien connu comme vert, rouge,…

L’extrait de code suivant illustre la modification des paramètres de police du côté client dans GridWeb.

Exemple de code

Ajouter/Supprimer des commentaires du côté client

Aspose.Cells GridWeb prend désormais en charge l’ajout et la suppression de commentaires côté client. Pour cela, le API met à disposition les fonctions “addcomments” et “delcomments”. L’extrait de code suivant montre l’ajout et la suppression de commentaires côté client dans GridWeb.

Exemple de code

Afficher les boutons pour ajouter/supprimer des feuilles de calcul

Aspose.Cells GridWeb prend désormais en charge l’ajout et la suppression de feuilles à l’aide des boutons de la barre d’outils. Pour que les boutons soient visibles sur le frontend, vous devez définirGridWeb1.ShowAddButton à vrai*. L’extrait de code suivant illustre l’ajout de boutons Ajouter/Supprimer à la barre d’outils GridWeb.

Exemple de code