Mail Merge from Excel in C# | Excel Mail Merge to Excel

A mala direta facilita a criação de documentos personalizados em massa, como cartas, e-mails, faturas ou certificados. Você começa com um modelo e o preenche usando dados de uma planilha. Cada linha no arquivo Excel gera um novo documento com os detalhes corretos nos lugares certos. É uma maneira inteligente de automatizar tarefas repetitivas, como o envio de faturas ou a geração de relatórios. Neste post, vamos mostrar como realizar uma mala direta a partir do Excel usando C#. Vamos começar.

Este artigo aborda os seguintes tópicos:

Biblioteca de Mesclagem de Mail do Excel em C#

Nós usaremos a Aspose.Cells for .NET API para realizar a mesclagem de correspondência a partir do Excel em C#. Ela oferece ferramentas poderosas para trabalhar com arquivos do Excel diretamente no seu código. Permite que os desenvolvedores criem, leiam e atualizem planilhas com facilidade. Você também pode lidar com tarefas avançadas como mesclagem de correspondência sem problemas. A biblioteca torna a automação do Excel rápida, flexível e confiável.

Para começar com Aspose.Cells for .NET, siga estas simples instruções de instalação:

  1. Por favor, faça o download em releases.
  2. Instale a biblioteca usando NuGet Package Manager com o seguinte comando:
PM> Install-Package Aspose.Cells

Como funciona a mesclagem de correspondência com Aspose.Cells?

Aspose.Cells não suporta “mail merge” da mesma maneira que o Word.Ele adiciona mail merge ao Excel usando Smart Markers.Esses marcadores atuam como espaços reservados em sua planilha, e a biblioteca os substitui por dados reais em tempo de execução. À medida que processa cada linha de sua fonte de dados, ela preenche o modelo e expande o conteúdo automaticamente, permitindo que você gere documentos totalmente personalizados com apenas algumas linhas de código C#.

&=DataSource.ColumnName

Durante o processamento, Aspose.Cells substitui isso por dados reais de um DataTable, List<T> ou qualquer IEnumerable. Por exemplo, a biblioteca substitui &=Data.Name pelos valores da coluna Name na tabela de Dados.

Prepare o Modelo do Excel

Crie um arquivo Excel (por exemplo, Template.xlsx) com marcadores inteligentes. Aqui está um layout de amostra:

NomeEmailMontante
&=Data.Name&=Data.Email&=Data.Amount

Guia Passo a Passo para Realizar Mala Direta a Partir do Excel em C#

Para realizar uma mesclagem de correio a partir do Excel usando Aspose.Cells for .NET, basta seguir estas etapas:

Passo 1: Carregue o modelo do Excel

Carregue o arquivo de modelo do Excel que contém Marcadores Inteligentes usando a classe Workbook. A classe Workbook representa todo o arquivo do Excel (livro de trabalho).O arquivo de modelo carregado atua como o layout para sua saída mesclada.

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

Passo 2: Criar uma DataTable

Aqui, criamos um DataTable que simula sua fonte de dados do Excel. Cada coluna corresponde a um marcador inteligente, e cada linha representa um conjunto de valores a serem inseridos. A classe DataTable de System.Data contém os dados que você deseja mesclar. Cada coluna corresponde a um marcador inteligente, e cada linha fornece um conjunto único de valores.

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: Vincule seu modelo do Excel à fonte de dados

Nós usamos a WorkbookDesigner classe para conectar o modelo com os dados. A WorkbookDesigner é uma classe especial no Aspose.Cells projetada para lidar com marcadores inteligentes e ligação de dados. Ela vincula sua fonte de dados (como um DataTable) ao modelo do Excel. O método SetDataSource() vincula o DataTable (Data) aos marcadores inteligentes na pasta de trabalho.

WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
  • SetDataSource() anexa o DataTable aos Smart Markers na pasta de trabalho.
  • "Data" é o nome usado nos marcadores como &=Data.Name.

Passo 4: Execute a Mala Direta

Uma vez que você definiu a fonte de dados, chamar Process() preenche todos os Smart Markers com valores reais da DataTable. Este comando executa a mesclagem de correspondência. Ele percorre os Smart Markers e os substitui por valores reais da fonte de dados.

designer.Process();

Passo 5: Salvar o Arquivo

Finalmente, salvamos o arquivo completo com todos os dados mesclados.

workbook.Save("MergedOutput.xlsx");

Salve a Saída Mesclada como um PDF

Você pode facilmente salvar o documento Excel mesclado como um PDF com uma única linha de código.

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

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

Complete C# Code to Mail Merge Data

// Carregue o template do 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);

// Defina a fonte de dados
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);

// Processar marcadores inteligentes (mesclagem de correspondência)
designer.Process();

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

Output

O arquivo de saída do Excel contém uma linha para cada entrada com dados personalizados preenchidos no lugar dos marcadores inteligentes.

Mail Merge do Excel em C# - Saída

Mail Merge do Excel em C# - Saída

Obtenha uma Licença Gratuita

Obtenha uma licença temporária gratuita que permite que você teste todos os recursos do Aspose.Cells for .NET sem limitações. É ideal se você estiver avaliando a API para tarefas de automação como mala direta, relatórios do Excel ou exportação para PDF.

Excel to Excel Mail Merge: Recursos Gratuitos

Além da mesclagem de correspondência do Excel, fornecemos vários recursos para ajudá-lo a aprofundar sua compreensão do Aspose.Cells for .NET. Confira nossa documentação, tutoriais e fóruns da comunidade para mais insights.

Perguntas Frequentes (FAQs)

Q1: Posso usar a mala direta do Excel sem o Microsoft Office instalado?

Sim, mala direta não requer Microsoft Office. Aspose.Cells funciona de forma independente e trata tudo por meio de suas próprias APIs.

Q2: Qual é a diferença entre Marcadores Inteligentes e Campos de Mesclagem do Word?

Smart Markers funcionam dentro do Excel e são mais personalizáveis para expansão de dados linha a linha. Os campos de mesclagem são específicos do Word.

Q3: Posso mesclar do Excel para o Word usando Aspose?

Sim, mas você precisará do Aspose.Words para esse cenário.

Q4: É possível automatizar a geração de PDF a partir de mesclagens do Excel?

Absolutamente. Apenas salve a pasta de trabalho final no formato PDF usando Aspose.Cells.

Conclusão

A mesclagemail do Excel oferece uma maneira poderosa de gerar documentos dinâmicos e personalizados usando a interface de planilha familiar. Neste post do blog, nós passamos pelo processo de mesclagem mail do Excel usando C#. Ao usar os Marcadores Inteligentes do Aspose.Cells, você ganha a flexibilidade de automatizar completamente esse processo e gerar milhares de faturas, certificados ou qualquer relatório estruturado.

Se você tiver alguma dúvida ou precisar de mais assistência, sinta-se à vontade para entrar em contato em nosso free support forum.

Veja também