IRONSOFTWAREHOME

Como Copiar Células em C# com IronXL

Curtis Chau
Curtis Chau
Updated: 4 de junho de 2026

IronXL permite copiar células, intervalos, linhas ou colunas em planilhas do Excel usando um único método Copy que preserva toda a formatação e estilo ao duplicar dados entre quaisquer locais ou planilhas.

O recurso "Copiar célula" duplica o conteúdo da célula e cola em outras células. Ele replica dados, fórmulas, formatação e outros atributos dentro da planilha. Quer criando planilhas do zero ou carregando arquivos Excel existentes, a funcionalidade de cópia é essencial para uma manipulação de dados eficiente.

Início Rápido: Copie uma Coluna ou Intervalo em Uma Linha

Copie intervalos inteiros — células únicas, linhas, colunas ou blocos — de uma planilha para outra usando uma chamada de método. A função Copy retém o estilo e a formatação, tornando a automação do Excel rápida e simples.

  1. 1Install IronXL with NuGet Package Manager

    PM > Install-Package IronXL.Excel

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

    workSheet.GetColumn(0).Copy(workBook.GetWorkSheet("Sheet1"), "H1");
  3. 3Implante para testar em seu ambiente de produção.

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

Como Copio uma Única Célula no Excel?

Para copiar o conteúdo de uma célula selecionada, use o método Copy. Passe o objeto planilha como o primeiro parâmetro e a posição inicial como o segundo parâmetro. O método Copy retém todo o estilo, incluindo fonte e tamanho, padrões e cores de fundo, e bordas e alinhamento.

using IronXL;

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

// Copy cell content
workSheet["A1"].Copy(workBook.GetWorkSheet("Sheet1"), "B3");

workBook.SaveAs("copySingleCell.xlsx");

Quais Formatações São Preservadas ao Copiar?

O método Copy preserva todas propriedades da célula, incluindo:

  • Valores e fórmulas Cell
  • Formatos de número (moeda, percentual, datas)
  • Estilo de fonte (tipo, tamanho, negrito, itálico, cor)
  • Bordas de célula e cores de fundo
  • Alinhamento de texto (horizontal e vertical)
  • Configurações de proteção de célula

Esta preservação abrangente garante que as células copiadas mantenham sua aparência e funcionalidade originais, semelhante ao uso de Ctrl+C e Ctrl+V no Microsoft Excel.

Planilha mostrando a célula A1 selecionada com seta apontando para a célula B3 contendo valor copiado, demonstrando a cópia de uma única célula

Por Que o Método de Cópia Exige Dois Parâmetros?

O método Copy requer dois parâmetros para controle preciso:

  1. Parâmetro da planilha: Especifica a planilha de destino (mesma ou diferente dentro do livro)
  2. Parâmetro de endereço: Define a posição inicial da célula para o conteúdo colado

Este design permite a cópia flexível dentro da mesma planilha ou em diferentes planilhas, ideal para a criação de relatórios de resumo ou consolidação de dados de várias fontes.

Quando Devo Usar Cópia de Célula Única vs Cópia de Intervalo?

Escolha cópia de célula única quando:

  • Duplicando valores ou fórmulas individuais
  • Copiando células ou etiquetas de cabeçalho
  • Replicando resultados calculados específicos
  • Trabalhando com valores resumidos

Use a cópia de intervalo quando:

  • Movendo tabelas de dados inteiras
  • Duplicando várias células relacionadas
  • Copiando linhas ou colunas completas
  • Preservar relações de dados

Como Posso Copiar Múltiplas Células ou Intervalos?

Como o método Clear, Copy está disponível na classe Range, permitindo a execução em qualquer tamanho de intervalo. Ao selecionar intervalos, IronXL oferece opções flexíveis de cópia:

  • Copiar uma única célula (C10):

    workSheet["C10"].Copy(workBook.GetWorkSheet("Sheet1"), "B13");
  • Copy a column (A):

    workSheet.GetColumn(0).Copy(workBook.GetWorkSheet("Sheet1"), "H1");
  • Copiar uma linha (4):

    workSheet.GetRow(3).Copy(workBook.GetWorkSheet("Sheet1"), "A15");
  • Copiar um intervalo bidimensional (D6:F8):

    workSheet["D6:F8"].Copy(workBook.GetWorkSheet("Sheet1"), "H17");
Observe: O segundo parâmetro aceita um local de endereço que marca o ponto de partida da entrada de dados. Os dados copiados começarão a partir desse endereço e se espalharão para a direita e para baixo.
using IronXL;

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

// Copy a single cell(C10)
workSheet["C10"].Copy(workBook.GetWorkSheet("Sheet1"), "B13");

// Copy a column(A)
workSheet.GetColumn(0).Copy(workBook.GetWorkSheet("Sheet1"), "H1");

// Copy a row(4)
workSheet.GetRow(3).Copy(workBook.GetWorkSheet("Sheet1"), "A15");

// Copy a two-dimensional range(D6:F8)
workSheet["D6:F8"].Copy(workBook.GetWorkSheet("Sheet1"), "H17");

workBook.SaveAs("copyCellRange.xlsx");

O Que Acontece Quando o Intervalo de Destino É Muito Pequeno?

IronXL lida automaticamente com diferenças de tamanho:

  • O parâmetro de destino especifica apenas a célula inicial no canto superior esquerdo
  • Todo o intervalo de origem é copiado, independentemente do tamanho de destino
  • Dados existentes na área de destino são sobrescritos
  • A operação de cópia se expande para acomodar todos os dados de origem

Por exemplo, copiar um intervalo 3x3 para a célula B1 preenche as células B1:D3, substituindo qualquer conteúdo existente.

Como Funcionam as Referências de Linhas e Colunas?

IronXL usa indexação de base zero para linhas e colunas com os métodos GetRow() e GetColumn():

  • GetColumn(0) refere-se à coluna A
  • GetColumn(1) refere-se à coluna B
  • GetRow(0) refere-se à linha 1
  • GetRow(3) refere-se à linha 4

Esta indexação está alinhada com as convenções padrão de arrays C#.

Por que usar os métodos GetColumn() e GetRow()?

Os métodos GetColumn() e GetRow() oferecem:

  • Desempenho: Mais eficiente para linhas ou colunas inteiras
  • Clareza: Torna a intenção do código mais clara
  • Flexibilidade: Retorna um objeto Range que suporta todas as operações de intervalo
  • Conveniência: Não é necessário calcular células finais para seleções completas

Esses métodos se destacam ao criar relatórios que exigem cópias de colunas completas ou ao duplicar modelos de linha.

Operações de cópia do Excel mostrando setas de intervalos de origem A1:F10 para células de destino com dados copiados destacados

Como Posso Copiar Células Entre Diferentes Planilhas?

O primeiro parâmetro aceita um objeto de planilha, permitindo copiar e colar entre diferentes planilhas. Passe um objeto de planilha diferente como o primeiro parâmetro. Essa funcionalidade é essencial ao gerenciar várias planilhas ou criar folhas resumo a partir de dados detalhados.

Observe: No exemplo a seguir, o primeiro parâmetro do método Copy é a planilha "Sheet2": workBook.GetWorksheet("Sheet2")
using IronXL;

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

// Copy cell content
workSheet["A1"].Copy(workBook.GetWorkSheet("Sheet2"), "B3");

workBook.SaveAs("copyAcrossWorksheet.xlsx");

Quais São os Cenários Comuns de Cópia Entre Planilhas?

A cópia entre planilhas frequentemente serve para estes cenários:

  1. Criando Planilhas Resumidas: Copiar métricas chave de planilhas detalhadas para dashboards
  2. Replicação de Modelos: Copiar modelos formatados para novas planilhas
  3. Consolidação de Dados: Reunir dados de planilhas departamentais em planilhas principais
  4. Geração de Relatórios: Copiar resultados filtrados para planilhas de relatórios separadas
  5. Operações de Backup: Duplicar dados críticos em planilhas de backup

Ao trabalhar com fórmulas que referenciam outras células, IronXL ajusta automaticamente as referências relativas com base na nova localização enquanto mantém as referências absolutas.

Quando Devo Copiar para uma Nova Planilha vs Existente?

Copie para uma nova planilha quando:

  • Criando relatórios periódicos (diários, semanais, mensais)
  • Isolando dados processados de dados brutos
  • Construindo planilhas de análise a partir de dados de origem
  • Gerando visualizações de dados específicas do usuário

Copiar para uma planilha existente quando:

  • Incorporando dados em registros contínuos
  • Atualizando seções de dashboards
  • Consolidando múltiplas fontes de dados
  • Mantendo registros históricos

Para cenários complexos que envolvem múltiplas planilhas, considere usar a capacidade do IronXL de trabalhar com DataSets e DataTables para manipulação sofisticada de dados.

Como lidar com conflitos de nomes de planilhas?

Garanta o gerenciamento adequado das planilhas ao copiar entre planilhas:

// Check if worksheet exists before copying
if (workBook.GetWorkSheet("TargetSheet") == null)
{
    workBook.CreateWorkSheet("TargetSheet");
}

// Safe copy operation
WorkSheet targetSheet = workBook.GetWorkSheet("TargetSheet");
sourceSheet["A1:Z100"].Copy(targetSheet, "A1");

Essa abordagem previne erros de tempo de execução e garante operações de cópia bem-sucedidas, especialmente importante ao automatizar processos do Excel em ambientes de produção.

Perguntas frequentes

Como faço para copiar uma única célula no Excel usando C#?

Com o IronXL, você pode copiar uma única célula usando o método Copy. Basta selecionar a célula que deseja copiar (por exemplo, workSheet["A1"]) e chamar o método Copy, passando a planilha de destino e o endereço da célula de destino como parâmetros. O IronXL preserva toda a formatação, incluindo fontes, cores, bordas e fórmulas, durante a operação de cópia.

Que formatação é preservada ao copiar células?

O método Copiar do IronXL preserva todas as propriedades das células, incluindo valores e fórmulas, formatos de número (moeda, porcentagem, datas), estilo da fonte (tipo, tamanho, negrito, itálico, cor), bordas e cores de fundo, alinhamento do texto (horizontal e vertical) e configurações de proteção. Isso garante que as células copiadas mantenham sua aparência e funcionalidade originais.

Posso copiar colunas ou intervalos inteiros de uma só vez?

Sim, o IronXL permite copiar colunas, linhas ou intervalos inteiros em uma única operação. Você pode usar métodos como GetColumn(0).Copy() para copiar uma coluna inteira ou selecionar um intervalo de células para copiar várias células de uma só vez. O método Copy funciona com qualquer tamanho de seleção, desde células individuais até planilhas inteiras.

Como faço para copiar células entre planilhas diferentes?

O IronXL facilita a cópia de células entre planilhas. Ao usar o método Copy, especifique a planilha de destino como o primeiro parâmetro (por exemplo, workBook.GetWorkSheet("Sheet2")) e o endereço da célula de destino como o segundo parâmetro. Isso permite copiar dados entre diferentes planilhas dentro da mesma pasta de trabalho.

Quais são os passos mínimos necessários para copiar células no Excel?

Com o IronXL, copiar células requer apenas 5 passos: 1) Baixe a biblioteca IronXL C#, 2) Carregue sua planilha Excel existente, 3) Selecione o intervalo, linha ou coluna que deseja copiar, 4) Invoque o método Copy no intervalo selecionado e 5) Passe uma planilha de destino e a posição para o método Copy. Toda a operação pode ser feita em uma única linha de código.

What happens if the destination range is smaller than the source when copying cells with IronXL?

When the destination range is smaller, IronXL's `Copy` function still accommodates the full source range by overwriting any existing data in the destination area, expanding as needed to fit all copied data.

Why might I choose to copy to a new worksheet rather than an existing one?

Copying to a new worksheet is recommended for creating periodic reports, isolating processed data, building analysis sheets, and generating user-specific views. This ensures data separation and clarity in reporting.

How do row and column references work in IronXL?

IronXL uses zero-based indexing where `GetColumn(0)` refers to column A, and `GetRow(0)` refers to row 1. This aligns with C# array conventions, making it intuitive for developers familiar with standard C# practices.

What are common scenarios for cross-worksheet copying with IronXL?

Cross-worksheet copying in IronXL is commonly used for creating summary sheets, replicating templates to new sheets, consolidating data from multiple sources, generating reports, and performing backup operations of critical data.

How does IronXL handle worksheet naming conflicts during copy operations?

IronXL manages worksheet naming conflicts by allowing you to check for and create target sheets if they don't exist, ensuring safe copy operations without runtime errors, which is crucial for automating Excel processes.

Curtis Chau
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 bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 2,237,574Versão:2026.9recém-lançado

Obtenha o seu GRÁTIS

Obtenha uma chave de avaliação de 30 dias instantaneamente.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.
bullet_testTeste em produção
sem marcas d'água
bullet_calendar30 dias completos
produto funcional
bullet_supportSuporte técnico 24 horas por dia,
5 dias por semana, durante o teste
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.9

PM > Install-Package IronXL.Excel
nuget.org/packages/IronXL.Excel/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronXL".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.9

  1. Baixe e descompacte o IronXL em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronXL.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.