Obtenir la plage avec des liens externes dans la feuille de calcul

Introduction

Dans le monde actuel axé sur les données, la gestion efficace des fichiers Excel est essentielle pour les entreprises comme pour les particuliers. Grâce à des outils puissants comme Aspose.Cells pour .NET, travailler avec des fichiers Excel devient un jeu d’enfant. Que vous génériez des rapports, gériez des données ou analysiez simplement des chiffres, comprendre comment manipuler et extraire des données à partir de feuilles de calcul peut vous faire gagner du temps et vous éviter des maux de tête. Dans ce didacticiel, nous verrons comment obtenir la plage avec des liens externes dans une feuille de calcul à l’aide d’Aspose.Cells pour .NET.

Prérequis

Avant de plonger dans le code et divers exemples, vous devez vous assurer que vous disposez des conditions préalables suivantes :

  1. .NET Framework : assurez-vous que vous exécutez une version de .NET Framework compatible avec Aspose.Cells.
  2. Bibliothèque Aspose.Cells : vous devez avoir installé la bibliothèque Aspose.Cells. Vous pouvez la récupérer à partir deici.
  3. Visual Studio ou IDE similaire : il est utile de disposer d’un IDE adapté pour écrire et exécuter votre code C#.
  4. Exemple de fichier Excel : pour ce didacticiel, utilisez un fichier Excel appeléSampleExternalReferences.xlsx, qui devrait contenir des liens externes à des fins de démonstration. Maintenant que nous avons terminé cette liste de contrôle, mettons les mains dans le cambouis avec le code !

Paquets d’importation

Pour commencer à utiliser la fonctionnalité Aspose.Cells, vous devez importer les espaces de noms nécessaires dans votre projet. Cela vous permettra d’accéder à des classes telles queWorkbook, Name , etReferredArea. Voici comment configurer vos importations :

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

Assurez-vous que la bibliothèque Aspose.Cells est correctement référencée dans votre projet. Maintenant que nous avons importé les packages requis, commençons par charger le classeur qui contient les données avec lesquelles nous voulons travailler. Cette étape est cruciale car si le fichier n’est pas chargé correctement, rien d’autre ne fonctionnera.

Étape 1 : Définissez votre répertoire source

Tout d’abord, spécifiez le répertoire dans lequel se trouve votre fichier Excel. Il s’agit d’une simple affectation de chaîne, mais elle définit le contexte du chargement de votre classeur.

string sourceDir = "Your Document Directory";

Étape 2 : charger le classeur

Ensuite, vous allez créer une instance deWorkbook en passant le chemin d’accès à votre fichier Excel. Assurez-vous de concaténer le répertoire avec le nom du fichier.

Workbook workbook = new Workbook(sourceDir + "SampleExternalReferences.xlsx");

Vous avez maintenant le classeur chargé et prêt à être utilisé !

Itération à travers des plages nommées

Les plages nommées peuvent contenir des liens externes et, pour examiner ces liens, vous devez parcourir les plages nommées dans la feuille de calcul.

Étape 3 : Accéder aux plages nommées

Vous utiliserez unforeach boucle pour parcourir les plages nommées contenues dansworkbook.Worksheets.NamesC’est ici que la magie opère !

foreach (Name namedRange in workbook.Worksheets.Names)

Étape 4 : Obtenir des zones référencées

Dans cette boucle, vous pouvez appeler la méthodeGetReferredAreas(true)sur la plage nommée. Cette méthode renvoie un tableau deReferredArea objets qui pointent vers des liens externes.

ReferredArea[] referredAreas = namedRange.GetReferredAreas(true);

Étape 5 : Vérifiez les zones référencées

Voici un contrôle de sécurité. Assurez-vous toujours que les zones référencées ne sont pas nulles avant de procéder à leur traitement.

if (referredAreas != null)

Boucle à travers les zones référencées

Maintenant que vous disposez des zones référencées, il est temps de creuser encore plus profondément en parcourant ces zones pour extraire les données pertinentes.

Étape 6 : parcourir les zones référencées

Utilisez une boucle for simple pour parcourir chaqueReferredArea objet dans lereferredAreas tableau.

for (int i = 0; i < referredAreas.Length; i++)

Étape 7 : Extraire les informations de chaque zone

Ici, vous allez créer une variable pour chaqueReferredArea et commencez ensuite à extraire les informations essentielles telles que s’il s’agit d’un lien externe, le nom de la feuille et les détails de la plage.

ReferredArea referredArea = referredAreas[i];
Console.WriteLine("IsExternalLink: " + referredArea.IsExternalLink);
Console.WriteLine("IsArea: " + referredArea.IsArea);
Console.WriteLine("SheetName: " + referredArea.SheetName);
Console.WriteLine("ExternalFileName: " + referredArea.ExternalFileName);
Console.WriteLine("StartColumn: " + referredArea.StartColumn);
Console.WriteLine("StartRow: " + referredArea.StartRow);
Console.WriteLine("EndColumn: " + referredArea.EndColumn);
Console.WriteLine("EndRow: " + referredArea.EndRow);

Finalisation de l’opération

Après avoir traité toutes les zones référencées, il est recommandé de terminer par une confirmation que l’opération a été exécutée avec succès.

Étape 8 : Message de confirmation

Enfin, vous souhaiterez afficher un message sur la console confirmant l’exécution réussie de l’opération.

Console.WriteLine("GetRangeWithExternalLinks executed successfully.\r\n");

Conclusion

Et voilà ! Nous venons de parcourir un didacticiel complet sur la façon d’obtenir des plages avec des liens externes à partir d’une feuille de calcul Excel à l’aide d’Aspose.Cells pour .NET. En suivant ces étapes (chargement du classeur, itération dans les plages nommées, extraction des zones référencées et génération des résultats), vous pouvez facilement gérer les liens externes dans vos fichiers Excel. Aspose.Cells simplifie ces tâches, vous permettant de vous concentrer davantage sur l’analyse et moins sur la récupération des données.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une bibliothèque robuste pour créer, manipuler et convertir des feuilles de calcul Excel dans des applications .NET.

Comment installer Aspose.Cells ?

Vous pouvez télécharger la bibliothèque à partir dece lien et suivez les instructions d’installation fournies sur le site.

Quels types de fichiers Excel Aspose.Cells prend-il en charge ?

Il prend en charge une large gamme de formats de fichiers, notamment XLS, XLSX, CSV et autres.

Puis-je obtenir des références externes à partir d’une plage nommée ?

Oui, vous pouvez utiliser leGetReferredAreasméthode pour accéder aux références externes liées à une plage nommée.

Existe-t-il un essai gratuit pour Aspose.Cells ?

Oui, vous pouvez commencer avec unessai gratuit ici.

Obtenir la validation des cellules dans le fichier ODS Obtenir l'identifiant unique de la feuille de calcul