Mail Merge da Excel in C# | Mail Merge di Excel in Excel

La fusione della corrispondenza rende facile creare documenti personalizzati in massa, come lettere, email, fatture o certificati. Inizi con un modello e lo compili utilizzando i dati di un foglio di calcolo. Ogni riga nel file Excel genera un nuovo documento con i dettagli corretti nei posti giusti. È un modo intelligente per automatizzare compiti ripetitivi come l’invio di fatture o la generazione di report. In questo post, ti mostreremo come eseguire una fusione della corrispondenza da Excel utilizzando C#. Iniziamo.

Questo articolo tratta i seguenti argomenti:

C# Mail Merge Excel Library

Utilizzeremo l’ API Aspose.Cells for .NET per eseguire un’unione di corrispondenza da Excel in C#. Offre strumenti potenti per lavorare con i file Excel direttamente nel tuo codice. Permette agli sviluppatori di creare, leggere e aggiornare fogli di calcolo con facilità. Puoi anche gestire compiti avanzati come l’unione di corrispondenza senza problemi. La libreria rende l’automazione di Excel rapida, flessibile e affidabile.

Per iniziare con Aspose.Cells for .NET, segui queste semplici istruzioni per l’installazione:

  1. Per favore scaricalo da releases.
  2. Installa la libreria utilizzando NuGet Package Manager con il seguente comando:
PM> Install-Package Aspose.Cells

Come funziona la Stampa Unione con Aspose.Cells?

Aspose.Cells non supporta `la fusione di posta” nello stesso modo di Word.Aggiunge la fusione di posta a Excel utilizzando Smart Markers.Questi marker agiscono come segnaposto nel tuo foglio di calcolo e la libreria li sostituisce con dati reali durante l’esecuzione. Mentre elabora ogni riga dal tuo sorgente dati, compila il modello ed espande automaticamente il contenuto, permettendoti di generare documenti completamente personalizzati con solo poche righe di codice C#.

&=DataSource.ColumnName

Durante l’elaborazione, Aspose.Cells sostituisce questi con dati effettivi da un DataTable, List<T> o qualsiasi IEnumerable. Ad esempio, la libreria sostituisce &=Data.Name con valori dalla colonna Nome nella tabella Dati.

Prepara il modello Excel

Crea un file Excel (ad esempio, Template.xlsx) con marker intelligenti. Ecco un layout di esempio:

NomeEmailImporto
&=Data.Name&=Data.Email&=Data.Amount

Step-by-Step Guide to Perform Mail Merge from Excel in C#

Per effettuare una fusione di corrispondenza da Excel utilizzando Aspose.Cells for .NET, segui semplicemente questi passaggi:

Passo 1: Carica il modello Excel

Carica il file del modello Excel che contiene Smart Markers utilizzando la classe Workbook. La classe Workbook rappresenta l’intero file Excel (workbook).Il file modello caricato funge da layout per il tuo output unito.

Workbook workbook = new Workbook("Template.xlsx");

Passo 2: Crea una DataTable

Qui, creiamo un DataTable che simula la tua fonte di dati Excel. Ogni colonna corrisponde a un marcatore intelligente e ogni riga rappresenta un insieme di valori da inserire. La classe DataTable di System.Data contiene i dati che desideri unire. Ogni colonna corrisponde a un marcatore intelligente e ogni riga fornisce un insieme unico di valori.

DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1500);

Passo 3: Collega il tuo modello Excel alla fonte di dati

Utilizziamo la classe WorkbookDesigner per collegare il modello con i dati. La classe WorkbookDesigner è una classe speciale in Aspose.Cells progettata per gestire marcatori intelligenti e binding dei dati. Collega la tua sorgente dati (come un DataTable) con il modello Excel. Il metodo SetDataSource() associa il DataTable (Data) ai marcatori intelligenti nel workbook.

WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
  • SetDataSource() collega il DataTable ai Smart Markers nel workbook.
  • "Data" è il nome usato nei marcatori come &=Data.Name.

Passaggio 4: Esegui la Unione di Mail

Una volta che hai impostato la sorgente dati, chiamando Process() vengono riempiti tutti i Smart Marker con valori reali dalla DataTable. Questo comando esegue la fusione di lettere. Scorre i Smart Marker e li sostituisce con valori effettivi dalla sorgente dati.

designer.Process();

Passo 5: Salva il File

Finalmente, salviamo il file completato con tutti i dati uniti.

workbook.Save("MergedOutput.xlsx");

Salva l’output unito come PDF

Puoi facilmente salvare il documento Excel unito come PDF con una singola riga di codice.

// Set PDF options
PdfSaveOptions options = new PdfSaveOptions();

// Save as PDF
workbook.Save("MergedDocument.pdf", SaveFormat.Pdf);

Complete C# Code to Mail Merge Data

// Carica il modello Excel
Workbook workbook = new Workbook("Template.xlsx");

// Create dummy data
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1200);

// Imposta la sorgente dei dati
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);

// Processa marcatori intelligenti (fusione di corrispondenza)
designer.Process();

// Save the output
workbook.Save("MergedOutput.xlsx");

Output

Il file Excel di output contiene una riga per ciascun elemento con dati personalizzati popolati al posto dei marker intelligenti.

Mail Merge da Excel in C# - Output

Mail Merge da Excel in C# - Output

Ottieni una licenza gratuita

Ottieni una licenza temporanea gratuita che ti consente di testare tutte le funzionalità di Aspose.Cells for .NET senza limitazioni. È ideale se stai valutando l’API per attività di automazione come unione di corrispondenza, reportistica Excel o esportazione in PDF.

Excel per la corrispondenza per email: Risorse gratuite

In aggiunta alla fusione della posta di Excel, forniamo varie risorse per aiutarti ad approfondire la tua comprensione di Aspose.Cells for .NET. Dai un’occhiata alla nostra documentazione, tutorial e forum della comunità per ulteriori approfondimenti.

Domande frequenti (FAQ)

Q1: Posso utilizzare la funzione di stampa unione in Excel senza aver installato Microsoft Office?

Sì, la stampa unione non richiede Microsoft Office. Aspose.Cells funziona in modo indipendente e gestisce tutto attraverso le proprie API.

Q2: Qual è la differenza tra Smart Markers e Word Merge Fields?

I marker intelligenti funzionano all’interno di Excel e sono più personalizzabili per l’espansione dei dati riga per riga. I campi di unione sono specifici di Word.

Q3: Posso unire da Excel a Word utilizzando Aspose?

Sì, ma avrai bisogno di Aspose.Words per quel scenario.

Q4: È possibile automatizzare la generazione di PDF da fusioni di Excel?

Assolutamente. Salva semplicemente il file di lavoro finale in formato PDF utilizzando Aspose.Cells.

Conclusione

La fusione della posta da Excel offre un modo potente per generare documenti dinamici e personalizzati utilizzando l’interfaccia familiare di un foglio di calcolo. In questo post del blog, abbiamo illustrato la fusione della posta da Excel utilizzando C#. Utilizzando i marker intelligenti di Aspose.Cells, ottieni la flessibilità di automatizzare completamente questo processo e generare migliaia di fatture, certificati o qualsiasi rapporto strutturato.

Se hai domande o hai bisogno di ulteriore assistenza, non esitare a contattarci nel nostro free support forum.

See Also