Como editar um arquivo do Excel em C#

Editar Arquivo Excel em C

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

Edite arquivos Excel em C# usando a biblioteca IronXL, que fornece métodos simples para modificar células, linhas, colunas e planilhas programaticamente sem Interop do Excel, reduzindo erros e complexidade.

Os desenvolvedores precisam de precisão ao modificar arquivos Excel em C# porque um erro pode corromper documentos inteiros. Código simples e eficiente reduz o risco de erro e simplifica a edição ou exclusão programática de arquivos Excel. IronXL fornece uma solução abrangente para trabalhar com arquivos Excel em C# que elimina dependências do Microsoft Office. Este guia cobre os passos para editar arquivos Excel em C# de forma correta e rápida usando funções testadas.

Início Rápido: Edite um Valor de Célula Específico com IronXL

Este exemplo mostra como carregar um arquivo Excel existente, atualizar uma única célula e salvar as alterações usando IronXL. Comece em menos de 5 linhas, sem necessidade de Interop. Para operações complexas, explore nossa Referência de API abrangente.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXl.Excel
  2. Copie e execute este trecho de código.

    IronXl.WorkBook.Load("file.xlsx").GetWorkSheet("Sheet1")["C3"].Value = "Hello IronXL";
    // then save your workbook
    iroExcelWorkBook.SaveAs("file.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

Passo 1

Como Configuro o IronXL para Edição Excel C#?

Este tutorial usa IronXL, uma biblioteca Excel para C#. Baixe e instale em seu projeto (gratuito para desenvolvimento) para usar essas funções. IronXL suporta várias plataformas incluindo Linux e macOS, tornando-o versátil para desenvolvimento multiplataforma.

You can either Download IronXL.zip or read more and install via the NuGet package page.

Uma vez instalado, vamos começar. Novo no IronXL? Consulte nosso Visão Geral de Introdução para uma introdução abrangente.


Install-Package IronXl.Excel

Substitua x.x.x pelo número de versão apropriado conforme necessário.


Tutorial de Como Fazer

Como Eu Edito Valores de Células Específicos no Excel?

Primeiro, aprenda como editar valores específicos de células de uma Planilha Excel. Esta é uma das operações mais comuns quando editando arquivos Excel em C#.

Importe a Planilha Excel para modificar, em seguida, acesse sua Planilha de Trabalho. Aplique as modificações como mostrado abaixo. IronXL oferece várias formas de acessar células, oferecendo flexibilidade para diferentes estilos de programação.

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-specific-cell-value.cs
using IronXL;

// Load the Excel workbook
WorkBook wb = WorkBook.Load("sample.xlsx");
// Access a specific worksheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Access specific cell by identifying its row and column, then modify its value
ws.Rows[3].Columns[1].Value = "New Value";
// Save changes to the workbook
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

Aqui estão capturas de tela antes e depois da planilha do Excel sample.xlsx:

Antes Depois
Planilha do Excel com célula destacada mostrando 'França' na coluna País, demonstrando seleção de célula para edição Célula B4 do Excel mostrando 'Novo Valor' com borda de seleção azul após editar o conteúdo da célula

Veja como é simples modificar o valor da Planilha Excel. Esta abordagem funciona bem ao atualizar pontos de dados específicos sem afetar o restante da sua planilha.

Uma maneira alternativa de editar valores de células específicos pelo endereço da célula:

// Alternative way to access specific cell and apply changes
ws["B4"].Value = "New Value";
// Alternative way to access specific cell and apply changes
ws["B4"].Value = "New Value";
$vbLabelText   $csharpLabel

Como Eu Edito Valores de Linhas Completas no Excel?

Edite valores de linhas completas de uma Planilha Excel com um valor estático facilmente. Esta operação ajuda ao atualizar registros inteiros de uma vez, como redefinir dados ou aplicar atualizações em massa. Para operações complexas de linhas, explore adição de linhas e colunas.

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-row-value.cs
using IronXL;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Setting a static value for the entire row
ws.Rows[3].Value = "New Value";
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

Veja as capturas de tela de sample.xlsx abaixo:

Antes Depois
Planilha do Excel com a linha 4 destacada mostrando dados do segmento Governamental para França com produto Montana Tabela do Excel mostrando nova linha com entradas 'Novo Valor' adicionadas em todas as colunas em uma planilha de dados de vendas

Edite valores de um intervalo específico dentro de uma linha usando a função de intervalo:

// Editing a specific range of a row
ws["A3:E3"].Value = "New Value";
// Editing a specific range of a row
ws["A3:E3"].Value = "New Value";
$vbLabelText   $csharpLabel

Ao trabalhar com intervalos, você também pode precisar de selecione intervalos para operações avançadas como classificação ou aplicação de fórmulas.


Como Eu Edito Valores de Colunas Completas no Excel?

Edite colunas completas de valores da Planilha Excel com um único valor facilmente. Isso funciona bem para cenários como atualizar colunas de moeda, aplicar novas taxas de imposto ou padronizar formatos de dados em toda uma coluna.

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-full-column.cs
using IronXL;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Setting a static value for the entire column
ws.Columns[1].Value = "New Value";
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

Isso produz nossa planilha sample.xlsx conforme mostrado:

Antes Depois
Planilha do Excel com coluna País destacada em azul, mostrando dados empresariais através de segmentos e países Planilha do Excel mostrando coluna B preenchida com texto 'Novo Valor' após operação de edição em massa da coluna

Como Eu Edio uma Linha Completa com Valores Dinâmicos?

IronXL permite editar linhas específicas com valores dinâmicos. Edite uma linha completa atribuindo valores dinâmicos para cada célula. Esta abordagem funciona bem ao importar dados de bancos de dados ou outras fontes que exigem valores únicos por célula. Veja o exemplo:

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-full-row-dynamic.cs
using IronXL;
using System.Linq;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
for (int i = 0; i < ws.Columns.Count(); i++)
{
    // Assign dynamic values to each cell in the row
    ws.Rows[3].Columns[i].Value = "New Value " + i.ToString();
}
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

A tabela abaixo mostra capturas de tela da planilha do Excel sample.xlsx deste resultado:

Antes Depois
Planilha do Excel com linha 4 destacada mostrando dados do segmento Enterprise antes da edição com valores dinâmicos Planilha do Excel com linha 4 mostrando texto placeholder 'Novo Valor 0-4' após operação de edição dinâmica de linha

Como posso editar uma coluna inteira com valores dinâmicos?

Edite colunas específicas com valores dinâmicos simplesmente. Essa técnica ajuda a preencher colunas com dados sequenciais como números ID, datas ou valores calculados com base na posição da linha.

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-full-column-dynamic.cs
using IronXL;
using System.Linq;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
for (int i = 0; i < ws.Rows.Count(); i++)
{
    // Skip the first row if it's used as a header
    if (i == 0)
        continue;
    // Assign dynamic values to each cell in the column
    ws.Rows[i].Columns[1].Value = "New Value " + i.ToString();
}
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

Com os resultados da tabela de sample.xlsx abaixo:

Antes Depois
Planilha do Excel com coluna País destacada, mostrando dados empresariais através de segmentos e produtos Planilha do Excel mostrando coluna País preenchida com valores placeholder dinâmicos 'Novo Valor 1-9' após operação de edição em massa

Como substituo valores em uma planilha Excel?

Substitua qualquer tipo de valor por um valor atualizado em uma planilha do Excel usando a função Replace. Use essa função para substituir dados da planilha Excel em qualquer situação necessária. Isso funciona bem para limpeza de dados, atualização de terminologia ou correção de erros sistemáticos em planilhas.

Como substituo valores em uma planilha inteira?

Para substituir um valor específico por toda uma planilha do Excel WorkSheet por um valor atualizado, acesse o WorkSheet ws (mesmo que os exemplos acima) e aplique a função Replace:

// Replace a specific value in the entire worksheet
ws.Replace("old value", "new value");
// Replace a specific value in the entire worksheet
ws.Replace("old value", "new value");
$vbLabelText   $csharpLabel

Esta função substitui old value por new value em uma planilha do Excel WorkSheet completa. É um recurso poderoso para atualizações em massa que de outra forma exigiriam operações manuais de localizar e substituir no Excel.

Lembre-se de salvar o arquivo após qualquer alteração, conforme mostrado nos exemplos acima. Para mais informações sobre salvar e exportar arquivos Excel, veja nosso guia sobre conversão de tipos de arquivo de planilha.

Como faço para substituir valores em uma linha específica?

Para fazer alterações em uma linha específica em vez de toda a planilha, use este código:

// Replace a specific value in a specific row
ws.Rows[2].Replace("old value", "new value");
// Replace a specific value in a specific row
ws.Rows[2].Replace("old value", "new value");
$vbLabelText   $csharpLabel

O código acima substitui old value por new value apenas na linha número 2. O restante do WorkSheet permanece inalterado.

Como substituo valores em um intervalo de linhas?

Substitua valores dentro de um intervalo específico da seguinte forma:

// Replace specific values in a row range
ws["From Cell Address : To Cell Address"].Replace("old value", "new value");
// Replace specific values in a row range
ws["From Cell Address : To Cell Address"].Replace("old value", "new value");
$vbLabelText   $csharpLabel

Para substituir um valor antigo por um novo no intervalo de B4 a E4 da linha número 4, escreva:

ws["B4:E4"].Replace("old value", "new value");
ws["B4:E4"].Replace("old value", "new value");
$vbLabelText   $csharpLabel

Como faço para substituir valores em uma coluna específica?

Substitua valores de uma coluna específica mantendo o restante da planilha inalterado:

// Replace specific values in a column
ws.Columns[1].Replace("old value", "new value");
// Replace specific values in a column
ws.Columns[1].Replace("old value", "new value");
$vbLabelText   $csharpLabel

O código acima substitui old value por new value apenas para a coluna número 1.

Como substituo valores em um intervalo de colunas?

Use a função de intervalo para substituir dentro de um intervalo de uma coluna específica:

// Replace specific values in a column range
ws["B5:B10"].Replace("old value", "new value");
// Replace specific values in a column range
ws["B5:B10"].Replace("old value", "new value");
$vbLabelText   $csharpLabel

O código acima substitui old value por new value apenas dentro do intervalo de B5 a B10 para a coluna B.


Como removo uma linha da planilha Excel?

IronXL fornece uma função simples para remover uma linha específica de uma planilha do Excel WorkSheet. Essa funcionalidade ajuda ao limpar dados ou remover registros desatualizados de planilhas. Veja o exemplo:

:path=/static-assets/excel/content-code-examples/how-to/csharp-edit-excel-file-row-value.cs
using IronXL;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");
// Setting a static value for the entire row
ws.Rows[3].Value = "New Value";
wb.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

O código acima remove a linha número 3 de sample.xlsx conforme mostrado na tabela a seguir:

Antes Depois
Planilha do Excel com linha 4 destacada mostrando dados do segmento Governamental para Canadá antes da operação de remoção de linha Planilha do Excel com linha 4 destacada em azul mostrando o resultado após operação de remoção de linha

Como removo uma planilha de um arquivo Excel?

Para remover um WorkSheet completo de um arquivo Excel, use o seguinte método. Isso ajuda ao consolidar dados ou remover planilhas temporárias usadas para cálculos. Para mais informações sobre gerenciar planilhas, veja nosso guia sobre gerenciamento de planilhas.

// Remove a worksheet by its index
wb.RemoveWorkSheet(1); // by sheet indexing
// Remove a worksheet by its index
wb.RemoveWorkSheet(1); // by sheet indexing
$vbLabelText   $csharpLabel

wb é o WorkBook, assim como nos exemplos acima. Para remover uma planilha pelo nome:

// Remove a worksheet by its name
wb.RemoveWorkSheet("Sheet1"); //by sheet name
// Remove a worksheet by its name
wb.RemoveWorkSheet("Sheet1"); //by sheet name
$vbLabelText   $csharpLabel

IronXL inclui muitas funções adicionais para executar facilmente qualquer tipo de edição e exclusão em planilhas Excel. Explore recursos adicionais como criação de gráficos Excel, aplicação de formatação condicional ou trabalho com fórmulas. Entre em contato com nossa equipe de desenvolvimento para quaisquer perguntas sobre o uso do IronXL em seu projeto.


Acesso rápido à biblioteca

### Documentação da Biblioteca IronXL

Explore todas as funcionalidades da Biblioteca IronXL C# com várias funções para edição, exclusão, formatação e aperfeiçoamento de suas planilhas Excel.

Documentação da Biblioteca IronXL
Documentation related to Como removo uma planilha de um arquivo Excel?

Perguntas frequentes

Como faço para editar arquivos do Excel em C# sem o Microsoft Office instalado?

IronXL permite editar arquivos Excel em C# sem a necessidade do Microsoft Office ou do Excel Interop. Ele fornece uma biblioteca independente que pode modificar células, linhas, colunas e planilhas programaticamente, eliminando a dependência do Office e funcionando em diversas plataformas, incluindo Linux e macOS.

Qual é a maneira mais simples de atualizar o valor de uma célula em um arquivo Excel usando C#?

Com o IronXL, você pode atualizar o valor de uma célula com apenas algumas linhas de código: `IronXl.WorkBook.Load("file.xlsx").GetWorkSheet("Sheet1")["C3"].Value = "Hello IronXL";` seguido do salvamento da planilha. Essa abordagem não requer interoperabilidade com o Excel e fornece acesso direto à célula.

Posso editar linhas e colunas inteiras no Excel programaticamente?

Sim, o IronXL permite editar linhas e colunas inteiras com valores estáticos ou dinâmicos. Você pode modificar linhas inteiras com um único valor, preencher colunas programaticamente ou atualizar linhas com dados dinâmicos de diversas fontes, como bancos de dados ou cálculos.

Como faço para remover linhas ou planilhas de um arquivo Excel em C#?

O IronXL oferece métodos simples para remover linhas de planilhas e excluir planilhas inteiras de arquivos do Excel. Essas operações são realizadas programaticamente, sem a necessidade de instalar o Excel, o que o torna ideal para aplicações do lado do servidor.

É possível localizar e substituir valores em uma planilha do Excel?

Sim, o IronXL inclui funcionalidades para pesquisar e substituir valores em planilhas. Você pode encontrar valores específicos programaticamente e substituí-los por novos dados, de forma semelhante à função nativa de localizar e substituir do Excel, mas automatizada por meio de código C#.

Quais plataformas a biblioteca de edição do Excel em C# suporta?

O IronXL é compatível com diversas plataformas, incluindo Windows, Linux e macOS, o que o torna versátil para desenvolvimento multiplataforma. Isso permite editar arquivos do Excel em aplicativos C#, independentemente do ambiente de implantação.

Como posso começar a editar arquivos do Excel em C#?

Para começar, baixe e instale o IronXL através do gerenciador de pacotes NuGet. A biblioteca é gratuita para uso em desenvolvimento. Após a instalação, você pode começar imediatamente a carregar arquivos do Excel, modificar células e salvar alterações com um código simples e intuitivo.

Quais são as vantagens da edição programática do Excel em relação aos métodos manuais?

O IronXL permite a edição programática de arquivos Excel, reduzindo erros humanos, automatizando tarefas repetitivas e possibilitando operações em lote que seriam demoradas se realizadas manualmente. Além disso, elimina a necessidade de interoperabilidade com o Excel, reduzindo a complexidade e melhorando o desempenho.

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 ...

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

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.