Vérifiez si une valeur de cellule est dans un format de nombre personnalisé spécifique

Introduction

Lorsque vous travaillez avec des feuilles de calcul, en particulier dans un environnement professionnel, la précision et la mise en forme sont essentielles. Que vous effectuiez une analyse de données ou que vous créiez des rapports visuellement attrayants, il peut être très important de s’assurer que les valeurs des cellules sont conformes à des formats spécifiques. Aujourd’hui, nous nous penchons sur une application pratique d’Aspose.Cells pour .NET, où nous vous montrerons comment vérifier si une valeur de cellule adhère à un format numérique personnalisé spécifique. Si vous débutez avec Aspose.Cells ou si vous souhaitez perfectionner vos compétences, vous êtes au bon endroit !

Prérequis

Avant de plonger dans le code, vous devrez configurer quelques prérequis :

  1. Visual Studio installé : assurez-vous que Visual Studio (n’importe quelle version) est prêt sur votre machine, car nous travaillerons dans un environnement .NET.
  2. Bibliothèque Aspose.Cells pour .NET : vous devrez télécharger et ajouter la bibliothèque Aspose.Cells à votre projet. Vous pouvez récupérer la dernière versionici.
  3. Compréhension de base de C# : la familiarité avec la programmation C# vous aidera à suivre le cours de manière fluide.

Maintenant que nous avons défini nos prérequis, passons directement à l’importation des packages nécessaires.

Paquets d’importation

Pour travailler avec Aspose.Cells, vous devez d’abord importer les espaces de noms requis dans votre projet C#. En haut de votre fichier C#, ajoutez les directives using suivantes :

using Aspose.Cells;
using System;

Ces directives vous donnent accès à toutes les classes et méthodes disponibles dans la bibliothèque Aspose.Cells, vous permettant de créer et de manipuler des fichiers Excel sans effort.

Maintenant que tout est prêt, décomposons le processus en étapes faciles à suivre. Nous allons créer un classeur, définir une valeur de cellule, attribuer un format de nombre personnalisé et vérifier les exceptions sur les formats non valides. Voici comment procéder :

Étape 1 : Créer un classeur

Pour commencer, vous devez créer une instance d’un classeur. Il s’agit de la base de notre fichier Excel où résideront toutes les données et tous les styles.

// Créer un classeur
Workbook wb = new Workbook();

En initialisantWorkbook, nous créons un nouveau fichier Excel en mémoire, prêt à être manipulé.

Étape 2 : Configurer les paramètres du classeur

Ensuite, nous devons configurer les paramètres de notre classeur. Cela est essentiel car cela permet de détecter les erreurs liées aux formats de nombres personnalisés.

// Activer l'exception pour les formats de nombres personnalisés non valides
wb.Settings.CheckCustomNumberFormat = true;

ParamètreCheckCustomNumberFormat àtrue indique à Aspose.Cells de générer des exceptions chaque fois qu’un format non valide est appliqué, permettant une meilleure gestion des erreurs.

Étape 3 : Accéder à la première feuille de travail

Une fois votre classeur configuré, vous pouvez accéder à la première feuille de calcul où vos données seront stockées.

// Accéder à la première feuille de calcul
Worksheet ws = wb.Worksheets[0];

Cela vous donne une référence à la première feuille du classeur, où nous ajouterons nos données de cellule.

Étape 4 : Travailler avec une cellule

Maintenant que nous avons notre feuille de calcul, nous allons accéder à une cellule spécifique, dans ce cas, « A1 ». Nous allons ensuite saisir une valeur numérique dans cette cellule.

// Accédez à la cellule A1 et insérez un nombre à l'intérieur
Cell c = ws.Cells["A1"];
c.PutValue(2347);

En utilisantPutValue , nous insérons le numéro2347 dans la cellule « A1 ».

Étape 5 : définir le style de la cellule

Après avoir placé une valeur dans la cellule, il est temps d’accéder à son style et de le modifier.

// Accéder au style de la cellule et définir sa propriété Style.Custom
Style s = c.GetStyle();

Nous récupérons le style actuel de la cellule « A1 ». C’est ici que nous pouvons définir notre format de nombre personnalisé.

Étape 6 : Attribuer un format de numéro personnalisé

Nous allons maintenant essayer de définir un format de nombre personnalisé non valide pour voir comment notre classeur réagit.

try
{
    // Cette ligne générera une exception si le format n'est pas valide
    s.Custom = "ggg @ fff"; // Format de numéro personnalisé non valide
    c.SetStyle(s);
}
catch (Exception ex)
{
    Console.WriteLine("Exception Occurred. Exception: " + ex.Message);
}

Dans ce bloc de code, nous essayons de définir un format de nombre personnalisé non valide. Étant donné que nous avons activé la levée d’exceptions dans les paramètres de notre classeur, cela détectera tous les problèmes et imprimera le message d’erreur.

Étape 7 : Valider l’exécution réussie

Enfin, imprimez un message de confirmation pour indiquer que l’opération, réussie ou non, a été exécutée.

Console.WriteLine("CheckCustomNumberFormat executed successfully.");

Cela vous permet de constater que votre vérification a été exécutée, qu’elle ait réussi ou échoué.

Conclusion

L’exploration des fonctionnalités d’Aspose.Cells pour .NET fournit une boîte à outils polyvalente pour la gestion des fichiers Excel par programmation. Dans ce didacticiel, nous avons présenté une méthode pratique pour vérifier les valeurs des cellules par rapport à des formats de nombres personnalisés spécifiques, y compris la gestion des erreurs. Les fonctionnalités d’Aspose.Cells simplifient non seulement les manipulations Excel, mais améliorent également la productivité grâce à une gestion robuste des erreurs.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une bibliothèque .NET conçue pour créer, manipuler et convertir des fichiers Excel sans nécessiter l’installation de Microsoft Excel.

Puis-je essayer Aspose.Cells gratuitement ?

Oui, vous pouvez télécharger une version d’essai gratuite d’Aspose.Cellsici.

Où puis-je trouver de la documentation supplémentaire ?

Pour plus d’informations, consultez ledocumentation.

Quels langages de programmation Aspose.Cells prend-il en charge ?

Aspose.Cells prend principalement en charge les langages .NET tels que C# et VB.NET.

Comment puis-je signaler un problème ou obtenir de l’aide ?

Vous pouvez poser des questions ou signaler des problèmes sur leForum Aspose.

Spécifier les champs de formule lors de l'importation de données dans une feuille Excel