1. IronXL
  2. Tutoriais
  3. Mesclar células
Como mesclar e desmesclar células no Excel

Como Mesclar e Desmesclar Células em C# com IronXL

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL permite que desenvolvedores C# unam várias células do Excel em uma célula maior ou as desfaçam de volta para células individuais usando métodos simples como Merge("B3:D3") e Unmerge(), proporcionando flexibilidade para formatação e apresentação de dados sem Excel Interop.

⟨AH2BG⟩Início rápido: Mescle um intervalo de células com uma única chamada⟨AH2EG⟩

Em apenas algumas linhas, você pode carregar um livro de trabalho, unir um intervalo de células especificado usando o método Merge do IronXL e salvar o arquivo. É projetado para desenvolvedores começarem a unir células facilmente sem Excel Interop.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXl.Excel

  2. Copie e execute este trecho de código.

    var ws = WorkBook.Load("file.xlsx").DefaultWorkSheet; ws.Merge("B3:D3"); ws.SaveAs("merged.xlsx");

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas) IronXL C# library documentation showing 5-step process to merge and unmerge Excel cells with installation command
  1. Baixar biblioteca C# para mesclar e desmesclar células
  2. Carregar uma planilha existente ou criar uma nova
  3. Use o método `Merge` para mesclar o intervalo desejado
  4. Desmescle especificando o endereço ou índice do intervalo para o método `Unmerge`
  5. Exporte a planilha modificada.

Como Mesclar Células no Excel Usando C#?

O método Merge pode ser usado para unir um intervalo de células. Esse processo combina as células sem apagar quaisquer valores ou dados existentes, embora apenas o valor da primeira célula na região mesclada seja exibido. No entanto, os valores das células mescladas permanecem acessíveis no IronXL. Essa funcionalidade é particularmente útil ao criar planilhas com cabeçalhos formatados ou ao trabalhar com modelos do Excel.

⟨PS0BG⟩Mesclar células dentro do intervalo de filtro pode causar conflitos no arquivo Excel, exigindo reparo do Excel para visualizar a planilha.⟨PSEG⟩

O exemplo de código abaixo demonstra como mesclar uma gama de células especificando seus endereços.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-merge.cs
using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var range = workSheet["B2:B5"];

// Merge cells B7 to E7
workSheet.Merge("B7:E7");

// Merge selected range
workSheet.Merge(range.RangeAddressAsString);

workBook.SaveAs("mergedCell.xlsx");
$vbLabelText   $csharpLabel

O Que Acontece com os Valores das Células ao Mesclar?

Demonstração de células mescladas no Excel mostrando dados de funcionários antes e depois de mesclar células destacadas entre colunas

Por Que a Mesclagem de Células às Vezes Causa Conflitos no Excel?

Mesclar células refere-se ao processo de combinar duas ou mais células adjacentes em uma única célula maior. Desmesclar células é o processo oposto, onde uma célula mesclada é dividida de volta em suas células individuais originais. Esse recurso permite flexibilidade, alinhamento consistente e melhor análise de dados. Ao trabalhar com formatação de células e estilo de células, células mescladas às vezes podem interferir com outros recursos do Excel, como classificação e filtragem.

Os conflitos do Excel geralmente ocorrem quando células mescladas se sobrepõem a intervalos de filtro ou ao tentar classificar dados que contêm células mescladas. Esses problemas surgem porque o Excel trata células mescladas como uma única unidade, o que pode atrapalhar operações normais em células individuais dentro desse intervalo. Entender essas limitações ajuda ao gerenciar planilhas e planejar sua estrutura de planilha.

Quando Devo Usar Mesclagem de Células em Aplicações de Negócios?

Mesclar células é particularmente útil para criar cabeçalhos que abrangem várias colunas, formatar relatórios para melhor apresentação visual e criar formulários com áreas de entrada de texto maiores. É comumente usado em modelos de fatura, dashboards e formulários de entrada de dados. Ao exportar para o Excel de aplicativos de negócios, células mescladas ajudam a criar documentos com aparência profissional.

Cenários comuns de negócios incluem:

  • Cabeçalhos de Relatório: Criando títulos que abrangem a largura dos seus dados
  • Design de Dashboard: Combinando células para estatísticas de resumo ou KPIs
  • Criação de Formulários: Mesclando células para áreas de entrada de texto maiores
  • Modelos de Fatura: Criando layouts profissionais com células mescladas para informações da empresa

Como Posso Recuperar Todas as Regiões Mescladas em uma Planilha?

Recuperar regiões mescladas é útil para identificar o valor exibido em software de visualização de planilhas, como Microsoft Excel. Para obter uma lista de regiões unidas, use o método GetMergedRegions. Isso é especialmente útil ao carregar planilhas existentes para entender sua estrutura.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-retrieve-merged-regions.cs
using IronXL;
using System.Collections.Generic;
using System;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Apply merge
workSheet.Merge("B4:C4");
workSheet.Merge("A1:A4");
workSheet.Merge("A6:D9");

// Retrieve merged regions
List<IronXL.Range> retrieveMergedRegions = workSheet.GetMergedRegions();

foreach (IronXL.Range mergedRegion in retrieveMergedRegions)
{
    Console.WriteLine(mergedRegion.RangeAddressAsString);
}
$vbLabelText   $csharpLabel

Por Que Eu Precisaria Obter Regiões Mescladas Programaticamente?

Obter regiões mescladas ajuda quando você precisa analisar a estrutura da planilha, validar a integridade dos dados ou replicar a formatação em outras planilhas. É essencial para aplicações que processam modelos ou realizam modificações de planilhas automatizadas. Essa capacidade torna-se crucial ao editar arquivos do Excel programaticamente ou ao construir ferramentas que precisam preservar a formatação existente.

Casos de uso para recuperar regiões mescladas incluem:

  • Processamento de Modelos: Identificar regiões mescladas em modelos antes de preencher dados
  • Replicação de Formato: Copiar padrões de mesclagem de uma planilha para outra
  • Validação de Dados: Garantindo a integridade dos dados ao processar arquivos com células mescladas
  • Geração de Relatório: Compreendendo os padrões de mesclagem existentes para criação dinâmica de relatórios

Em que Ordem as Regiões Mescladas São Retornadas?

As regiões mescladas são retornadas em ordem cronológica, com base na sua criação. Essa ordenação é importante ao usar operações de desmesclagem baseadas em índice. Entender essa ordem ajuda ao implementar funcionalidades como desfazer/refazer ou quando você precisa selecionar intervalos específicos para processamento.

Como Desmesclar Células no Excel com IronXL?

A desmesclagem de regiões mescladas pode ser realizada utilizando duas abordagens diferentes. O primeiro método e o mais simples envolve especificar os endereços das células, como B3:B6, para desfazer a união.

Alternativamente, você pode desmesclar células com base no índice da região mesclada. As regiões mescladas são listadas em ordem cronológica. Para fazer isso, primeiro recupere as regiões unidas e passe o índice desejado para o método Unmerge. Essa flexibilidade permite lidar com vários cenários ao processar arquivos Excel programaticamente.

ObserveO endereço da célula deve corresponder exatamente à região mesclada. Você não pode desmesclar partes da região mesclada.

:path=/static-assets/excel/content-code-examples/how-to/csharp-excel-merge-cells-unmerge.cs
using IronXL;

WorkBook workBook = WorkBook.Load("mergedCell.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Unmerge the merged region of B7 to E7
workSheet.Unmerge("B7:E7");

workBook.SaveAs("unmergedCell.xlsx");
$vbLabelText   $csharpLabel

Quais São os Problemas Comuns ao Desmesclar Células?

Comparação de planilhas do Excel mostrando células mescladas (esquerda) versus células desmescladas (direita) com dados de funcionários

Qual Método de Desmesclagem Devo Usar?

Use a desmesclagem baseada em endereço quando souber as coordenadas exatas da região mesclada. Use a desmesclagem baseada em índice ao iterar por todas as regiões mescladas programaticamente ou quando os endereços exatos puderem variar. Aqui está uma comparação para ajudar você a decidir:

Desmesclagem Baseada em Endereço:

  • Melhor para modelos estáticos com padrões de mesclagem conhecidos
  • Ideal ao processar relatórios padronizados
  • Código mais simples ao lidar com regiões específicas

Desmesclagem Baseada em Índice:

  • Perfeito para planilhas dinâmicas com padrões de mesclagem variáveis
  • Útil ao processar arquivos enviados por usuários
  • Melhor para processamento em lote de múltiplas regiões mescladas

Para cenários mais complexos envolvendo manipulação de células, explore a Referência da API do IronXL para descobrir métodos e propriedades adicionais para lidar eficientemente com células mescladas.

Perguntas frequentes

Como faço para mesclar células no Excel usando C#?

Você pode mesclar células no Excel usando C# com o método Merge do IronXL. Basta carregar sua planilha, chamar o método Merge com o intervalo de células (por exemplo, ws.Merge("B3:D3")) e salvar o arquivo. Isso combina várias células em uma única célula maior sem exigir a interoperabilidade com o Excel.

O que acontece com os valores das células quando elas são mescladas?

Ao usar o IronXL para mesclar células, o processo combina as células sem apagar nenhum valor ou dado existente. Apenas o valor da primeira célula na região mesclada será exibido na célula resultante, mas o IronXL ainda permite acessar todos os valores originais programaticamente.

Por que a mesclagem de células às vezes causa conflitos no Excel?

Os conflitos no Excel geralmente ocorrem quando células mescladas se sobrepõem a intervalos de filtro ou ao tentar classificar dados que contêm células mescladas. O IronXL ajuda a identificar esses problemas — a mesclagem de células dentro de intervalos de filtro pode exigir a reparação do Excel para que a planilha seja visualizada corretamente.

Posso desfazer a mesclagem de células que já foram mescladas?

Sim, o IronXL oferece um método Unmerge que permite separar células mescladas e devolvê-las às suas células individuais originais. Você pode desfazer a mesclagem especificando o endereço do intervalo ou o índice, o que proporciona flexibilidade para análise de dados e ajustes de formatação.

Preciso ter o Microsoft Excel instalado para mesclar células programaticamente?

Não, o IronXL permite mesclar e desmesclar células do Excel em C# sem a necessidade de instalar o Microsoft Excel ou o Excel Interop. A biblioteca funciona de forma independente, sendo ideal para ambientes de servidor e processos automatizados.

A mesclagem de células é útil para criar cabeçalhos formatados?

Sim, a funcionalidade de mesclagem do IronXL é particularmente útil ao criar planilhas com cabeçalhos formatados ou ao trabalhar com modelos do Excel. Ela permite criar layouts com aparência profissional, combinando células para títulos e cabeçalhos de seção.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Pronto para começar?
Nuget Downloads 1,890,100 | Versão: 2026.3 acaba de ser lançado

Nesta página

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXl.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.