IRONSOFTWAREHOME

Criar, Ler e Editar Arquivos Excel em .NET MAUI

Curtis Chau
Curtis Chau
Updated: 22 de abril de 2026

Introdução

Este Guia Explicativo explica como criar e ler arquivos Excel em aplicativos .NET MAUI para Windows usando o IronXL. Vamos começar.

IronXL: Biblioteca Excel em C#

IronXL é uma biblioteca C# .NET para ler, escrever e manipular arquivos Excel. Permite que usuários criem documentos Excel do zero, incluindo o conteúdo e aparência do Excel, bem como os metadados como título e autor. A biblioteca também oferece recursos de personalização para a interface do usuário, como configurar margens, orientação, tamanho da página, imagens e assim por diante. Não requer nenhum framework externo, integração de plataforma ou outras bibliotecas de terceiros para gerar arquivos Excel. É autônoma e independente.

Instale o IronXL


Para instalar o IronXL, você pode usar o Console do Gerenciador de Pacotes NuGet no Visual Studio. Abra o Console e insira o seguinte comando para instalar a biblioteca IronXL.

PM > Install-Package IronXL.Excel

Criando Arquivos Excel em C# usando IronXL

Desenhar a Interface do Aplicativo

Abra a página XAML chamada MainPage.xaml e substitua o código nela com o seguinte trecho de código.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUI_IronXl.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Label
                Text="Welcome to .NET Multi-platform App UI"
                SemanticProperties.HeadingLevel="Level2"
                SemanticProperties.Description="Welcome Multi-platform App UI"
                FontSize="18"
                HorizontalOptions="Center" />

            <Button
                x:Name="createBtn"
                Text="Create Excel File"
                SemanticProperties.Hint="Click on the button to create Excel file"
                Clicked="CreateExcel"
                HorizontalOptions="Center" />

            <Button
                x:Name="readExcel"
                Text="Read and Modify Excel file"
                SemanticProperties.Hint="Click on the button to read Excel file"
                Clicked="ReadExcel"
                HorizontalOptions="Center" />

        </VerticalStackLayout>
    </ScrollView>

</ContentPage>
XML

O código acima cria o layout para nosso aplicativo básico .NET MAUI. Ele cria um rótulo e dois botões. Um botão é para criar um arquivo Excel, e o segundo botão oferece suporte para ler e modificar o arquivo Excel. Ambos os elementos estão aninhados em um elemento pai VerticalStackLayout para que apareçam verticalmente alinhados em todos os dispositivos suportados.

Criar Arquivos Excel

É hora de criar o arquivo Excel usando o IronXL. Abra o arquivo MainPage.xaml.cs e escreva o seguinte método no arquivo.

private void CreateExcel(object sender, EventArgs e)
{
    // Create a new Workbook
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

    // Create a Worksheet
    var sheet = workbook.CreateWorkSheet("2022 Budget");

    // Set cell headers
    sheet["A1"].Value = "January";
    sheet["B1"].Value = "February";
    sheet["C1"].Value = "March";
    sheet["D1"].Value = "April";
    sheet["E1"].Value = "May";
    sheet["F1"].Value = "June";
    sheet["G1"].Value = "July";
    sheet["H1"].Value = "August";

    // Fill worksheet cells with random values
    Random r = new Random();
    for (int i = 2; i <= 11; i++)
    {
        sheet["A" + i].Value = r.Next(1, 1000);
        sheet["B" + i].Value = r.Next(1000, 2000);
        sheet["C" + i].Value = r.Next(2000, 3000);
        sheet["D" + i].Value = r.Next(3000, 4000);
        sheet["E" + i].Value = r.Next(4000, 5000);
        sheet["F" + i].Value = r.Next(5000, 6000);
        sheet["G" + i].Value = r.Next(6000, 7000);
        sheet["H" + i].Value = r.Next(7000, 8000);
    }

    // Apply formatting (background and border)
    sheet["A1:H1"].Style.SetBackgroundColor("#d3d3d3");
    sheet["A1:H1"].Style.TopBorder.SetColor("#000000");
    sheet["A1:H1"].Style.BottomBorder.SetColor("#000000");
    sheet["H2:H11"].Style.RightBorder.SetColor("#000000");
    sheet["H2:H11"].Style.RightBorder.Type = IronXL.Styles.BorderType.Medium;
    sheet["A11:H11"].Style.BottomBorder.SetColor("#000000");
    sheet["A11:H11"].Style.BottomBorder.Type = IronXL.Styles.BorderType.Medium;

    // Apply formulas
    decimal sum = sheet["A2:A11"].Sum();
    decimal avg = sheet["B2:B11"].Avg();
    decimal max = sheet["C2:C11"].Max();
    decimal min = sheet["D2:D11"].Min();

    sheet["A12"].Value = "Sum";
    sheet["B12"].Value = sum;

    sheet["C12"].Value = "Avg";
    sheet["D12"].Value = avg;

    sheet["E12"].Value = "Max";
    sheet["F12"].Value = max;

    sheet["G12"].Value = "Min";
    sheet["H12"].Value = min;

    // Save and open the Excel file
    SaveService saveService = new SaveService();
    saveService.SaveAndView("Budget.xlsx", "application/octet-stream", workbook.ToStream());
}

Este código-fonte cria um workbook e uma worksheet usando o IronXL, define valores de célula e formata as células. Também demonstra como usar fórmulas Excel com o IronXL.

Visualizar Arquivos Excel no Navegador

Abra o arquivo MainPage.xaml.cs e escreva o seguinte código.

private void ReadExcel(object sender, EventArgs e)
{
    // Store the path of the file
    string filepath = @"C:\Files\Customer Data.xlsx";
    WorkBook workbook = WorkBook.Load(filepath);
    WorkSheet sheet = workbook.WorkSheets.First();

    // Calculate the sum of a range
    decimal sum = sheet["B2:B10"].Sum();

    // Modify a cell value and apply styles
    sheet["B11"].Value = sum;
    sheet["B11"].Style.SetBackgroundColor("#808080");
    sheet["B11"].Style.Font.SetColor("#ffffff");

    // Save and open the Excel file
    SaveService saveService = new SaveService();
    saveService.SaveAndView("Modified Data.xlsx", "application/octet-stream", workbook.ToStream());

    DisplayAlert("Notification", "Excel file has been modified!", "OK");
}

O código-fonte carrega o arquivo Excel, aplica uma fórmula em um intervalo de células e formata com cores de fundo e texto personalizadas. Depois, o arquivo Excel modificado é salvo e uma notificação é exibida.

Salvar Arquivos Excel

Nesta seção, definimos a classe SaveService que salvará nossos arquivos Excel no armazenamento local.

Crie uma classe "SaveService.cs" e escreva o seguinte código:

using System;
using System.IO;

namespace MAUI_IronXL
{
    public partial class SaveService
    {
        public partial void SaveAndView(string fileName, string contentType, MemoryStream stream);
    }
}

Em seguida, crie uma classe chamada "SaveWindows.cs" dentro da pasta Platforms > Windows e adicione o seguinte código:

using System;
using System.Collections.Generic;
using System.IO;
using System.Runtime.InteropServices.WindowsRuntime;
using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Popups;

namespace MAUI_IronXL
{
    public partial class SaveService
    {
        public async partial void SaveAndView(string fileName, string contentType, MemoryStream stream)
        {
            StorageFile stFile;
            string extension = Path.GetExtension(fileName);
            IntPtr windowHandle = System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle;

            if (!Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons"))
            {
                FileSavePicker savePicker = new FileSavePicker();
                savePicker.DefaultFileExtension = ".xlsx";
                savePicker.SuggestedFileName = fileName;
                savePicker.FileTypeChoices.Add("XLSX", new List<string> { ".xlsx" });

                WinRT.Interop.InitializeWithWindow.Initialize(savePicker, windowHandle);
                stFile = await savePicker.PickSaveFileAsync();
            }
            else
            {
                StorageFolder local = ApplicationData.Current.LocalFolder;
                stFile = await local.CreateFileAsync(fileName, CreationCollisionOption.ReplaceExisting);
            }

            if (stFile != null)
            {
                using (IRandomAccessStream zipStream = await stFile.OpenAsync(FileAccessMode.ReadWrite))
                {
                    using (Stream outputStream = zipStream.AsStreamForWrite())
                    {
                        outputStream.SetLength(0);
                        stream.WriteTo(outputStream);
                        await outputStream.FlushAsync();
                    }
                }

                MessageDialog msgDialog = new("Do you want to view the document?", "File has been created successfully");
                UICommand yesCmd = new("Yes");
                msgDialog.Commands.Add(yesCmd);
                UICommand noCmd = new("No");
                msgDialog.Commands.Add(noCmd);

                WinRT.Interop.InitializeWithWindow.Initialize(msgDialog, windowHandle);

                IUICommand cmd = await msgDialog.ShowAsync();
                if (cmd.Label == yesCmd.Label)
                {
                    await Windows.System.Launcher.LaunchFileAsync(stFile);
                }
            }
        }
    }
}

Saída

Compile e execute o projeto MAUI. Com a execução bem-sucedida, uma janela será aberta mostrando o conteúdo representado na imagem abaixo.

Ler, criar e editar arquivos do Excel no .NET MAUI, Figura 1: Saída

Figura 1 - Resultado

Clicar no botão "Criar Arquivo Excel" abrirá uma janela de diálogo separada. Esta janela solicita aos usuários que escolham um local e um nome de arquivo para salvar um novo arquivo Excel (gerado). Especifique o local e o nome do arquivo conforme instruído e clique em OK. Em seguida, aparecerá outra janela de diálogo.

Ler, criar e editar arquivos do Excel no .NET MAUI, Figura 2: Pop-up de criação do Excel

Figura 2 - Criar Pop-up do Excel

Abrir o arquivo Excel conforme instruído no pop-up trará um documento como mostrado na captura de tela abaixo.

Ler, criar e editar arquivos do Excel no .NET MAUI, Figura 3: Saída

Figura 3 - Ler e Modificar Pop-up do Excel

Clicar no botão "Ler e Modificar Arquivo Excel" carregará o arquivo Excel gerado anteriormente e o modificará com as cores de fundo e texto personalizadas que definimos em uma seção anterior.

Ler, criar e editar arquivos do Excel no .NET MAUI, Figura 4: Saída do Excel

Figura 4 - Saída do Excel

Quando você abrir o arquivo modificado, verá a seguinte saída com índice.

Ler, criar e editar arquivos do Excel no .NET MAUI, Figura 5: Saída modificada do Excel

Figura 5 - Saída do Excel Modificada

Conclusão

Isso explicou como podemos criar, ler e modificar arquivos Excel no aplicativo .NET MAUI usando a biblioteca IronXL. IronXL tem um desempenho muito bom e realiza todas as operações com rapidez e precisão. É uma excelente biblioteca para operações do Excel, superando o Microsoft Interop, pois não requer nenhuma instalação do Microsoft Office Suite na máquina. Além disso, IronXL suporta múltiplas operações como criar livros de trabalho e planilhas, trabalhar com intervalos de células, formatação e exportação para vários tipos de documentos como CSV, TSV e mais.

IronXL suporta todos os templates de projeto como Windows Form, WPF, ASP.NET Core e muitos outros. Consulte nossos tutoriais para criar arquivos Excel e ler arquivos Excel para informações adicionais sobre como usar o IronXL.


Explore este Guia de Como Fazer no GitHub

O código-fonte deste projeto está disponível no GitHub.

Use este código como uma maneira fácil de começar em apenas alguns minutos. O projeto é salvo como um projeto do Microsoft Visual Studio 2022, mas é compatível com qualquer IDE .NET.

Como Ler, Criar e Editar Arquivos Excel em Aplicativos .NET MAUI

Consulte a Referência da API.

Explore a Referência da API para IronXL, delineando os detalhes de todas as funcionalidades, namespaces, classes, métodos, campos e enums do IronXL.

Consulte a Referência da API.

Perguntas frequentes

Como faço para criar um arquivo Excel em um aplicativo .NET MAUI?

Para criar um arquivo Excel em um projeto .NET MAUI, utilize a biblioteca IronXL para inicializar uma nova pasta de trabalho e planilha. Em seguida, você pode definir valores de células, aplicar fórmulas do Excel e personalizar a formatação antes de salvar o arquivo usando uma classe SaveService personalizada.

Posso ler arquivos Excel existentes em um aplicativo .NET MAUI?

Sim, você pode usar o IronXL para carregar e ler arquivos Excel existentes em um aplicativo .NET MAUI. A biblioteca permite acessar e modificar valores de células, aplicar fórmulas e implementar formatação personalizada.

Quais são os benefícios de usar o IronXL para manipulação de arquivos Excel em .NET MAUI?

O IronXL oferece uma solução completa para manipulação de arquivos Excel em .NET MAUI, eliminando a necessidade do Microsoft Office ou Interop. Ele permite criar, ler e editar arquivos Excel de forma eficiente e exportar para diversos formatos, como CSV e TSV.

Como posso instalar o IronXL no meu projeto .NET MAUI?

Você pode instalar o IronXL em seu projeto .NET MAUI usando o Console do Gerenciador de Pacotes NuGet no Visual Studio. Execute o comando: Install-Package IronXL.Excel para adicionar a biblioteca ao seu projeto.

É possível formatar células do Excel programaticamente em .NET MAUI?

Sim, com o IronXL, você pode formatar células do Excel programaticamente no .NET MAUI. Isso inclui definir estilos e cores de células, além de aplicar diversas opções de formatação para melhorar a aparência dos seus arquivos do Excel.

Como posso implementar uma classe SaveService para arquivos Excel no meu aplicativo .NET MAUI?

Para implementar uma classe SaveService no .NET MAUI, você pode criar uma classe que utilize a funcionalidade do IronXL para salvar arquivos do Excel no armazenamento local. Isso envolve a definição de métodos para especificar caminhos de arquivo e gerenciar operações de entrada/saída de arquivos.

Quais modelos de projeto o IronXL suporta em aplicações .NET?

O IronXL oferece suporte a uma variedade de modelos de projeto .NET, incluindo Windows Forms, WPF, ASP.NET Core e muito mais, proporcionando flexibilidade para desenvolvedores que trabalham em diferentes tipos de aplicativos.

Onde posso encontrar o código-fonte do projeto .NET MAUI para Excel?

O código-fonte do projeto .NET MAUI Excel, que utiliza o IronXL, está disponível no GitHub. Isso permite que os desenvolvedores configurem e experimentem rapidamente a manipulação de arquivos Excel em seus aplicativos usando o Visual Studio 2022.

Is IronXL compatible with different .NET project templates?

Yes, IronXL is compatible with various .NET project templates including Windows Forms, WPF, and ASP.NET Core, among others.

Where can I find additional resources and tutorials for using IronXL?

You can find additional tutorials and resources for using IronXL on the official [Iron Software website](https://ironsoftware.com) and their GitHub repository, which includes sample projects and API references.

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.