Ajouter des parties XML personnalisées avec ID au classeur

Introduction

Aspose.Cells for .NET est un outil puissant pour la gestion et la manipulation de fichiers Excel par programmation. L’une de ses fonctionnalités intéressantes est la possibilité d’intégrer des parties XML personnalisées dans votre classeur Excel. Cela peut sembler un peu technique, mais ne vous inquiétez pas ! À la fin de ce guide, vous aurez une solide compréhension de la manière d’ajouter des parties XML personnalisées avec des identifiants à votre classeur et de les récupérer en cas de besoin.

Prérequis

Avant de plonger dans le code, il est essentiel de configurer quelques éléments :

  1. Visual Studio : assurez-vous que Visual Studio est installé sur votre ordinateur, car nous l’utiliserons pour le codage.
  2. Aspose.Cells pour .NET : vous devez avoir installé Aspose.Cells pour .NET. Si vous ne l’avez pas encore fait, vous pouveztéléchargez-le ici.
  3. .NET Framework : une connaissance du framework .NET et du langage de programmation C# sera utile. Une fois les prérequis en place, il est temps de l’écraser avec un peu de magie de codage !

Paquets d’importation

Pour utiliser Aspose.Cells, vous devez ajouter l’espace de noms requis en haut de votre code. Voici comment procéder :

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Cette ligne vous permet d’accéder à toutes les fonctionnalités fournies par Aspose.Cells. Maintenant que nous avons posé le décor, décomposons le processus en étapes faciles à gérer. De cette façon, vous pourrez suivre le processus sans vous sentir dépassé.

Étape 1 : Créer un classeur vide

Pour commencer, vous devez créer une instance deWorkbook classe, qui représente votre classeur Excel.

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

Cette ligne simple initialise un nouveau classeur dans lequel nous pouvons ajouter nos parties XML personnalisées.

Étape 2 : Préparez vos données et votre schéma XML

Ensuite, vous devez préparer certaines données sous la forme d’un tableau d’octets. Bien que notre exemple utilise des données d’espace réservé, dans un scénario réel, vous remplaceriez ces tableaux d’octets par des données XML et un schéma réels que vous souhaitez intégrer dans votre classeur.

// Certaines données sous forme de tableau d'octets.
// Veuillez plutôt utiliser le XML et le schéma corrects.
byte[] btsData = new byte[] { 1, 2, 3 };
byte[] btsSchema = new byte[] { 1, 2, 3 };

N’oubliez pas que, même si cet exemple utilise des tableaux d’octets simples, vous utiliserez généralement ici du XML et un schéma valides.

Étape 3 : ajouter des parties XML personnalisées

Il est maintenant temps d’ajouter vos parties XML personnalisées au classeur. Vous pouvez le faire en appelant la fonctionAdd méthode sur leCustomXmlParts collection du cahier d’exercices.

// Créez quatre parties XML personnalisées.
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);
wb.CustomXmlParts.Add(btsData, btsSchema);

Cet extrait de code ajoute quatre parties XML personnalisées identiques au classeur. Vous pouvez le personnaliser selon vos besoins.

Étape 4 : Attribuer des identifiants aux parties XML personnalisées

Maintenant que nous avons ajouté nos parties XML, donnons à chacune d’elles un identifiant unique. Cet identifiant nous aidera à récupérer les parties XML plus tard.

//Attribuer des identifiants à des parties XML personnalisées.
wb.CustomXmlParts[0].ID = "Fruit";
wb.CustomXmlParts[1].ID = "Color";
wb.CustomXmlParts[2].ID = "Sport";
wb.CustomXmlParts[3].ID = "Shape";

Dans cette étape, vous attribuez des identifiants significatifs tels que « Fruit », « Couleur », « Sport » et « Forme ». Cela facilite l’identification et le travail ultérieur avec les différentes parties.

Étape 5 : Spécifier l’ID de recherche pour la partie XML personnalisée

Lorsque vous souhaitez récupérer une partie XML spécifique à l’aide de son ID, vous devez définir l’ID que vous recherchez.

// Spécifiez l'ID de la partie XML personnalisée de recherche.
String srchID = "Fruit";
srchID = "Color";
srchID = "Sport";

Dans une application réelle, vous souhaiterez probablement spécifier chaque ID de manière dynamique, mais pour notre exemple, nous en codons quelques-uns en dur.

Étape 6 : Rechercher une partie XML personnalisée par ID

Maintenant que nous avons nos identifiants de recherche, il est temps de rechercher la partie XML personnalisée correspondant à l’identifiant spécifié.

// Rechercher une partie XML personnalisée par l'ID de recherche.
Aspose.Cells.Markup.CustomXmlPart cxp = wb.CustomXmlParts.SelectByID(srchID);

Cette ligne s’appuie surSelectByID pour tenter de trouver la partie XML qui nous intéresse.

Étape 7 : Vérifiez si la partie XML personnalisée a été trouvée

Enfin, nous devons vérifier si la partie XML a été trouvée et imprimer un message approprié sur la console.

// Imprimez le message trouvé ou non trouvé sur la console.
if (cxp == null)
{
    Console.WriteLine("Not Found: CustomXmlPart ID " + srchID);
}
else
{
    Console.WriteLine("Found: CustomXmlPart ID " + srchID);
}
Console.WriteLine("AddCustomXMLPartsAndSelectThemByID executed successfully.");

Vous l’avez écrasé ! À ce stade, vous avez non seulement ajouté des parties XML personnalisées à votre classeur, mais également implémenté une fonctionnalité permettant de les rechercher par leurs identifiants.

Conclusion

Dans cet article, nous avons exploré comment ajouter des parties XML personnalisées à un classeur Excel à l’aide d’Aspose.Cells pour .NET. En suivant le guide étape par étape, vous avez pu créer un classeur, ajouter des parties XML personnalisées, attribuer des identifiants et les récupérer efficacement. Cette fonctionnalité peut s’avérer extrêmement utile lors du traitement de données dynamiques devant être traitées dans des fichiers Excel, rendant vos applications plus intelligentes et plus performantes.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une bibliothèque .NET robuste qui permet aux développeurs de créer, manipuler et convertir des fichiers Excel sans avoir besoin d’installer Microsoft Excel.

Puis-je utiliser Aspose.Cells gratuitement ?

Oui ! Vous pouvez commencer avec une version d’essai gratuite.téléchargez-le ici.

Est-il possible d’ajouter plusieurs parties XML personnalisées à un classeur ?

Absolument ! Vous pouvez ajouter autant de parties XML personnalisées que vous le souhaitez, et chacune d’entre elles peut se voir attribuer des identifiants uniques pour un accès facile.

Comment puis-je récupérer des parties XML si je ne connais pas les identifiants ?

Si vous ne connaissez pas les identifiants, vous pouvez parcourir lesCustomXmlParts collection pour voir les pièces disponibles et leurs identifiants, facilitant ainsi leur identification et leur accès.

Où puis-je trouver plus de ressources ou d’assistance pour Aspose.Cells ?

Vous pouvez consulter ledocumentation pour des conseils détaillés, ou visitez leForum de soutien pour l’aide communautaire.

Accéder aux informations de l'extension Web Excel à l'aide d'Aspose.Cells Ajouter une signature numérique au fichier Excel signé