Ir para o conteúdo do rodapé
USANDO O IRONXL

Como editar uma planilha em C#

Edite planilhas do Excel em C# usando a biblioteca IronXL sem o Microsoft Office, carregando cadernos de trabalho, manipulando valores de células com fórmulas e salvando arquivos—tudo por meio de operações baseadas em código simples.

Este artigo explorará a manipulação de planilhas em C#, usando a biblioteca IronXL chamada IronXL sem interagir com a interface do usuário. Quer você esteja trabalhando com arquivos Excel em aplicativos ASP.NET ou construindo soluções de desktop, o IronXL fornece uma abordagem abrangente para ler arquivos Excel e manipular dados de planilhas programaticamente.

Como eu edito uma planilha em C#?

A capacidade de editar e manipular dados de arquivos Excel usando C# pode ser extremamente útil para empresas e desenvolvedores. Aqui está como fazer isso em cinco passos simples:

  1. Instale a biblioteca C# para edição de planilhas.
  2. Use WorkBook.Load para abrir um arquivo Excel.
  3. Defina os valores das células usando o método Worksheet.Value.
  4. Aplique Range.Sum para calcular os totais das células.
  5. Salve o arquivo usando o método SaveAs.

Para desenvolvedores que buscam realizar operações mais avançadas, o IronXL também suporta criação de gráficos Excel programaticamente, aplicação de formatação condicional e trabalho com fórmulas.

O Que é IronXL e Por Que Devo Utilizá-lo?

IronXL é uma biblioteca abrangente projetada especificamente para processamento de planilhas C#. Ela permite que os desenvolvedores trabalhem com Excel em C# sem Interop, tornando-a ideal para ambientes de servidor e implantações em nuvem.

Quer você esteja trabalhando em um aplicativo financeiro, painel de dados ou qualquer projeto que envolva dados tabulares, o IronXL fornece uma solução robusta que simplifica operações complexas de planilhas no desenvolvimento C#. Você pode implementá-lo facilmente em seus aplicativos web ou aplicativos .NET. A biblioteca suporta implantação na AWS, ambientes Azure e até mesmo contêineres Docker.

Este artigo explorará os principais recursos e benefícios do IronXL, mostrando como ele aumenta a eficiência e funcionalidade de aplicações C# que lidam com processamento de planilhas Excel. Usando o IronXL, você pode manipular planilhas Excel sem precisar de aplicativos Microsoft Office, e você pode criar planilhas Excel avançadas sem Microsoft Excel e Excel Interop. A biblioteca também funciona perfeitamente em plataformas Linux e macOS, tornando-se verdadeiramente multiplataforma.

Como eu crio um novo projeto do Visual Studio para manipulação de Excel?

Antes de instalar o IronXL, é necessário criar um novo projeto C# no Visual Studio ou carregar um existente. Aqui estão os passos para criar um novo projeto no Visual Studio. Se você estiver trabalhando com diferentes frameworks, o IronXL também suporta .NET MAUI, Blazor e VB.NET.

Quais são os passos iniciais para configurar o Visual Studio?

  1. Abra o Visual Studio e clique no menu Arquivo. Um menu suspenso aparecerá. Clique em Novo no menu suspenso, e outro menu lateral aparecerá. Clique em Projeto.

    Menu Arquivo do Visual Studio expandido mostrando opções para criar um novo projeto, abrir repositórios e gerenciar arquivos Navegue até criar um novo projeto no Visual Studio

  2. Uma nova janela será aberta. Clique na barra de pesquisa e digite Console Application. Selecione aquele com a opção C#. Em seguida, clique no botão Next.

    Diálogo 'Criar um novo projeto' do Visual Studio mostrando modelos de Aplicativo de Console para C#, com a primeira opção destacada para criar um aplicativo de console .NET Core que roda no Windows, Linux e macOS Diálogo Criar um novo projeto no Visual Studio

Como Configuro as Configurações do Meu Projeto?

  1. Uma nova janela de configuração se abrirá. Escreva o nome do projeto, defina o local do projeto e, em seguida, clique no botão Next.

    Diálogo de configuração de novo projeto do Visual Studio mostrando as configurações para um Aplicativo de Console chamado 'SpreadSheet' visando as plataformas Windows, Linux, macOS e Console Configure o novo projeto

  2. A última janela aparecerá. Selecione o framework de destino e clique no botão Create.

    Diálogo de criação de projeto do Visual Studio mostrando a página de Informações Adicionais com a estrutura de destino .NET 5.0 selecionada para um Aplicativo de Console Seleção do Framework de Destino

Como Instalo a Biblioteca IronXL Spreadsheet?

Uma vez que o projeto é criado, vamos instalar a biblioteca gratuita IronXL C#. Aqui estão os passos para instalar IronXL no seu projeto C#. Você precisará aplicar uma chave de licença para uso em produção, mas a biblioteca oferece uma licença de teste para fins de avaliação.

Qual é a Melhor Maneira de Instalar o IronXL via NuGet?

  1. No Visual Studio, vá para Tools. Um menu suspenso aparecerá. Clique em NuGet Package Manager no menu suspenso e um menu lateral aparecerá. Clique em Manage NuGet Packages for Solution.

    Menu Ferramentas do Visual Studio aberto mostrando a opção Gerenciador de Pacotes NuGet no menu Ferramentas Navegar até o Gerenciador de Pacotes NuGet

  2. Uma nova janela será aberta. Vá para a guia Navegar e na barra de pesquisa, digite IronXL. Uma lista de pacotes IronXL aparecerá. Selecione o pacote mais recente e clique em instalar.

    Janela do Gerenciador de Pacotes NuGet mostrando o pacote IronXl.Excel selecionado com a versão 2023.11.12 pronta para instalação Instale o pacote IronXL no Gerenciador de Pacotes NuGet

Como Posso Editar Arquivos Excel e Planilhas Usando o IronXL?

O IronXL oferece muitos recursos de manipulação de planilhas que permitem alterar valores de células, tamanho da fonte, cor de fundo de colunas, intervalos de células e muito mais. A biblioteca suporta várias operações, incluindo adição de linhas e colunas, fusão de células, definição de bordas de células e alinhamento e aplicação de padrões e cores de fundo.

Esta seção demonstrará como carregar um conjunto de dados de um arquivo Excel de planilha, editá-lo e, em seguida, formatar e manipular os dados. Para operações mais avançadas, você também pode adicionar comentários às células, configurar hyperlinks e congelar painéis para uma melhor navegação em grandes planilhas.

Como Altero as Entradas da Planilha Usando C#?

Aqui está um exemplo de código que altera entradas do Excel usando C# com apenas algumas linhas de código. Esta abordagem é semelhante a editar arquivos Excel programaticamente, mas foca na manipulação básica de valores de célula.

Arquivo Excel de Entrada

Planilha Excel mostrando uma tabela de inventário simples com colunas de Itens, Quantidade, Preço e Total contendo dados para AXE, Caneta, Sapatos e Meias O arquivo Excel de entrada

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("test.xlsx");

// Get the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the value of cell A1
workSheet["A1"].Value = "Hello World Created by IronXL";

// Save the modified workbook as a new file
workBook.SaveAs("sample.xlsx");
using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("test.xlsx");

// Get the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the value of cell A1
workSheet["A1"].Value = "Hello World Created by IronXL";

// Save the modified workbook as a new file
workBook.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

O código fornecido usa a biblioteca IronXL em C# para manipular planilhas em arquivos Excel. Ele começa importando o namespace IronXL. Em seguida, carrega um arquivo Excel existente chamado "test.xlsx" em um objeto WorkBook usando a funcionalidade de carregar planilha.

A planilha padrão deste livro de trabalho é acessada e atribuída a uma variável WorkSheet. O código define o valor da célula A1 na planilha para "Hello World Created by IronXL". Finalmente, a planilha modificada é salva como um arquivo XLSX, "sample.xlsx", usando o método SaveAs. Para cenários mais complexos, você também pode converter entre diferentes tipos de arquivo de planilha ou exportar para formatos como CSV, JSON ou XML.

Arquivo de saída

Planilha Excel mostrando uma tabela de inventário simples com colunas para nomes de itens, quantidade, preço e totais calculados para produtos como AXE, Caneta, Sapatos e Meias O arquivo de saída

Como Posso Adicionar Fórmulas para Calcular Valores de Células?

O IronXL oferece uma versão gratuita deste recurso onde você pode usar fórmulas em planilhas e escrevê-las para outras células. Aqui está um exemplo usando a Biblioteca de Planilhas do C# IronXL. Para cálculos mais complexos, você pode explorar funções matemáticas e fórmulas do Excel em C#.

using IronXL;

// Load the existing Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Select a range of cells from D2 to D5
var range = workSheet["D2:D5"];

// Calculate the sum of the values in the range
decimal sum = range.Sum();

// Set the sum in cell D6 and label in C6
workSheet["D6"].Value = sum;
workSheet["C6"].Value = "Total Price:";

// Save the modified workbook
workBook.SaveAs("sample.xlsx");
using IronXL;

// Load the existing Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Select a range of cells from D2 to D5
var range = workSheet["D2:D5"];

// Calculate the sum of the values in the range
decimal sum = range.Sum();

// Set the sum in cell D6 and label in C6
workSheet["D6"].Value = sum;
workSheet["C6"].Value = "Total Price:";

// Save the modified workbook
workBook.SaveAs("sample.xlsx");
$vbLabelText   $csharpLabel

Este código usa a biblioteca IronXL em C# para manipular um arquivo Excel chamado "sample.xlsx." Começa carregando o arquivo Excel existente em um objeto WorkBook. Para mais informações sobre como trabalhar com intervalos, consulte nosso guia sobre seleção de intervalos.

A planilha padrão deste livro de trabalho é acessada e atribuída a uma variável WorkSheet. Subsequentemente, um intervalo específico de células, de D2 a D5, é selecionado usando a notação workSheet["D2:D5"].

A soma dos valores dentro deste intervalo é calculada usando o método Sum e armazenada em uma variável chamada "soma". Você também pode usar outras funções agregadas do Excel, como Média, Mínimo e Máximo.

O código atualiza a célula D6 na nova planilha com esta soma calculada, e a célula C6 é atribuída ao rótulo "Preço Total:". Finalmente, o livro de trabalho modificado é salvo de volta no mesmo arquivo, "sample.xlsx," usando o método SaveAs. Para formatação de dados, você pode aplicar formatos de dados de células para exibir números como moeda ou porcentagens.

Arquivo de saída

Planilha Excel mostrando uma lista de produtos com quantidade, preço e totais calculados, criada programaticamente com o cabeçalho 'Hello World Created by IronXL' O arquivo de saída

Recursos Adicionais de Manipulação de Excel

Além da edição básica de células e fórmulas, IronXL oferece recursos extensivos para manipulação abrangente de planilhas:

Quais São os Principais Pontos para Manipulação de Planilhas em C#?

Este artigo explorou a importância do C# na manipulação de planilhas e apresentou o IronXL como uma biblioteca poderosa que aprimora as capacidades do C#. Por meio de exemplos práticos, demonstramos como criar planilhas, editar valores de células e aplicar fórmulas sem a necessidade de dependências do Microsoft Office.

Este tutorial discutiu o processo de criação de um novo projeto C# no Visual Studio e delineou os passos para instalar o IronXL. O artigo também demonstrou exemplos práticos de uso do IronXL para editar arquivos do Excel, mostrando como alterar valores de células e aplicar fórmulas aos dados da planilha. Para aqueles que trabalham com diferentes fontes de dados, o IronXL também suporta importação de dados do Excel e exportação para vários formatos.

IronXL prova ser uma ferramenta valiosa para desenvolvedores que trabalham em projetos envolvendo análise de dados, relatórios e outras funcionalidades relacionadas a planilhas, fornecendo uma solução contínua e eficiente para exportação de dados em aplicativos C#. A extensa referência de API e tutoriais da biblioteca o tornam fácil de implementar operações complexas de Excel.

Além disso, o IronXL oferece uma ampla gama de recursos para interagir com Excel WorkBook, WorkSheet, e ao nível das Células, como conversão entre formatos populares, formatação de dados das células, mesclagem de células, inserção de funções matemáticas, e até gerenciamento de gráficos e adição de imagens. A biblioteca também suporta operações avançadas como agrupar e desagrupar linhas, gerenciar planilhas e limpar conteúdos de célula.

O código de exemplo e exemplos de uso de fórmulas em planilhas podem ser encontrados neste exemplo. Para o tutorial completo sobre edição de planilhas, visite o seguinte guia. Exemplos adicionais estão disponíveis na seção de exemplos de código, cobrindo tópicos desde leitura de arquivos Excel até trabalho com bancos de dados SQL.

Inscreva-se hoje na versão de teste do IronXL para começar a explorar todos os seus recursos e ver como o IronXL pode ajudar em seus projetos, seja para criar um novo arquivo do Excel, editar planilhas existentes ou adicionar novos dados de célula a uma planilha ou intervalo de células. A biblioteca continua a evoluir com atualizações regulares documentadas no changelog e melhorias de desempenho.

Se você achar o IronXL benéfico para o seu ambiente de trabalho e desejar continuar usando seus recursos para todas as suas necessidades de manipulação de dados de planilhas e muito mais, você pode adquirir uma licença assim que seu teste acabar. Para implantações empresariais, explore nossas opções de licenciamento e upgrades disponíveis.

Perguntas frequentes

Como manipular planilhas em C# sem usar Interop?

Você pode usar a biblioteca IronXL para manipular planilhas em C# sem depender da interoperabilidade (Interop). O IronXL permite realizar tarefas como editar, criar e formatar planilhas diretamente por meio de código.

Quais são os passos iniciais para editar uma planilha do Excel em C#?

Para editar uma planilha do Excel em C#, primeiro instale a biblioteca IronXL e, em seguida, carregue seu arquivo do Excel usando WorkBook.Load . Você pode modificar os valores das células usando Worksheet.Value e salvar as alterações com o método SaveAs .

Como instalar o IronXL em um projeto do Visual Studio?

Para instalar o IronXL em um projeto do Visual Studio, acesse Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para a Solução, pesquise por IronXL, selecione a versão mais recente e clique em Instalar.

O que torna o IronXL uma ferramenta poderosa para manipulação de planilhas em C#?

IronXL é uma ferramenta poderosa para manipulação de planilhas em C#, pois permite realizar uma ampla gama de operações, como aplicar fórmulas, converter formatos de arquivo, gerenciar gráficos e manipular imagens sem a necessidade do Microsoft Excel.

Como posso realizar a soma dos valores de células em uma planilha C#?

Para somar os valores das células em uma planilha C# usando o IronXL, selecione o intervalo desejado com workSheet["D2:D5"] , use o método range.Sum() para calcular a soma e atribua o resultado a uma célula com workSheet["D6"].Value .

É possível converter formatos de planilha usando uma biblioteca C#?

Sim, usando o IronXL, você pode converter formatos de planilhas facilmente. A biblioteca suporta vários tipos de arquivos do Excel e permite salvar suas planilhas em formatos como .XLSX, .CSV e outros.

Quais são os benefícios de usar uma versão de avaliação de uma biblioteca de planilha C#?

A versão de avaliação do IronXL permite explorar sua ampla gama de recursos para manipulação de dados em planilhas, ajudando você a avaliar suas capacidades para seus projetos em C# antes de adquirir uma licença completa.

Onde posso encontrar tutoriais sobre como usar uma biblioteca C# para manipulação de planilhas?

Você pode encontrar tutoriais e exemplos de como usar o IronXL para manipulação de planilhas no site oficial, principalmente nas seções "como fazer" e "exemplos", que abrangem vários recursos e casos de uso.

Jordi Bardia
Engenheiro de Software
Jordi é extremamente proficiente em Python, C# e C++, e quando não está utilizando suas habilidades na Iron Software, dedica-se à programação de jogos. Compartilhando as responsabilidades por testes, desenvolvimento e pesquisa de produtos, Jordi agrega imenso valor à melhoria contínua dos produtos. Essa experiência diversificada o mantém ...
Leia mais

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me