Introduzione

Hai mai desiderato lavorare in modo efficiente con i dati XML in Excel utilizzando .NET? Con Aspose.Cells per .NET, una potente libreria per la manipolazione dei fogli di calcolo, interagire con le mappe XML nei file Excel diventa semplice. In questo tutorial, esploreremo come interrogare aree specifiche mappate a percorsi XML nei file Excel, ideale per generare report dinamici o automatizzare l’estrazione dei dati. Analizziamo il processo passo dopo passo!

Prerequisiti

Prima di iniziare a programmare, assicurati di preparare quanto segue:

  1. Aspose.Cells per .NET: scaricalo Qui oppure installarlo tramite NuGet.
  2. Un file Excel mappato in XML: avrai bisogno di un file Excel (.xlsx) con una mappa XML già presente.
  3. Ambiente di sviluppo: questa guida è pensata per Visual Studio, ma funzionerà anche con altri editor C#.
  4. Licenza Aspose: puoi ottenere una licenza temporanea Qui se ne hai bisogno.

Configurazione dell’ambiente di sviluppo

Per iniziare, importa gli spazi dei nomi richiesti nel file di codice:

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

Importando questi pacchetti, si configura l’ambiente per accedere e manipolare la cartella di lavoro e i relativi fogli di lavoro.

Passaggio 1: carica il file Excel

Per prima cosa, dovrai caricare un file Excel contenente la mappatura XML:

// Definire la directory per il file sorgente
string sourceDir = "Your Document Directory"; // Aggiornare il percorso di conseguenza

// Carica il file Excel
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

Qui, Workbook rappresenta l’intero file Excel, che puoi caricare utilizzando il suo percorso file.

Passaggio 2: accedere alla mappa XML

Una volta caricato il file, accedi alla mappa XML all’interno della cartella di lavoro:

// Accedi alla prima mappa XML nella cartella di lavoro
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];

In questo modo verrà recuperata la prima mappa XML dalla cartella di lavoro. Se la cartella di lavoro contiene più mappe, modificare l’indice secondo necessità.

Passaggio 3: seleziona il foglio di lavoro

Successivamente, accedi al foglio di lavoro che contiene i dati XML mappati:

// Accedi al primo foglio di lavoro nella cartella di lavoro
Worksheet worksheet = workbook.Worksheets[0];

In questo caso, selezioniamo il primo foglio di lavoro, ma puoi facilmente selezionarne un altro se necessario.

Passaggio 4: interrogare la mappa XML

Ora, interroghiamo la mappa XML utilizzando un percorso XML. Ad esempio, se si desidera recuperare i dati da /MiscData percorso, dovresti fare:

// Interroga la mappa XML utilizzando il percorso
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);

Questo metodo accetta il percorso XML e recupera i dati correlati in un ArrayList.

Passaggio 5: visualizzare i risultati della query

Ora che abbiamo i dati interrogati, stampiamo i risultati sulla console:

// Visualizza i risultati della query
foreach (var result in results)
{
    Console.WriteLine(result);
}

Questo ciclo consente di visualizzare tutti gli elementi recuperati dal percorso XML.

Passaggio 6: interrogare un percorso XML annidato

Puoi perfezionare la tua query per ottenere dati più specifici. Ad esempio, se sei interessato alle informazioni sul colore trovate in /MiscData/row/Color, dovresti adattare la tua query in questo modo:

// Interrogazione di un percorso XML annidato
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);

Passaggio 7: visualizzare i risultati delle query nidificate

Infine, visualizziamo i dati di questo percorso specifico:

// Emette i risultati della query del percorso annidato
foreach (var result in results)
{
    Console.WriteLine(result);
}

Questo ciclo stamperà ogni elemento dalla query annidata, mostrandoti i dati di destinazione.

Conclusione

In questo tutorial, abbiamo esplorato come interrogare i dati XML mappati in file Excel utilizzando Aspose.Cells per .NET. Questa funzionalità è preziosa per gli sviluppatori che desiderano estrarre dinamicamente dati XML specifici. Con queste conoscenze di base, è ora possibile implementare query XML più complesse e persino lavorare con più mappature XML nei progetti Excel.

Domande frequenti

Posso mappare più file XML in una singola cartella di lavoro di Excel?

Sì, Aspose.Cells supporta la gestione di più mappe XML all’interno di una singola cartella di lavoro.

Cosa succede se il percorso XML non esiste nella mappa?

Se si interroga un percorso non valido, il XmlMapQuery restituirà un ArrayList vuoto.

È richiesta una licenza per utilizzare Aspose.Cells per .NET?

Sì, è necessaria una licenza per la piena funzionalità. A prova gratuita e un licenza temporanea sono disponibili.

Posso salvare i dati interrogati in un nuovo file Excel?

Assolutamente sì! Puoi estrarre i dati e salvarli in un altro file Excel o esportarli in diversi formati supportati da Aspose.Cells.

L’interrogazione di mappe XML è supportata in formati diversi da Excel (.xlsx)?

La mappatura XML è supportata principalmente nei file .xlsx e le funzionalità per altri formati potrebbero essere limitate.