VB .NET Excel Congelar a linha superior: Manter os cabeçalhos visíveis durante a rolagem

Como Instalar o IronXL para Seu Projeto .NET?

Antes de escrever qualquer código de congelamento de painel, adicione o IronXL ao seu projeto usando o Gerenciador de Pacotes NuGet. Abra o terminal e execute:

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

Alternativamente, utilize o Console do Gerenciador de Pacotes do Visual Studio:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

Após a instalação, adicione o namespace IronXL no topo do seu arquivo. IronXL é direcionado ao .NET 10 e suporta todas as plataformas principais -- Windows, Linux e macOS -- então sua lógica de congelamento de painéis funciona da mesma forma, independentemente de onde você implante.

Uma vez instalado, você pode carregar planilhas existentes ou criar novas em apenas algumas linhas. A biblioteca funciona com os formatos .xlsx (Excel 2007 e posterior) e .xls (Excel 97-2003), embora o suporte ao congelamento de painéis exija o formato moderno .xlsx. A tabela abaixo resume os principais métodos WorkSheet abordados neste guia.

Como Congelar Linhas em um Arquivo Excel?

A resposta é simples: use o método CreateFreezePane no seu objeto de planilha. Este método aceita parâmetros que controlam quais linhas e colunas permanecem visíveis enquanto o restante da planilha do Excel rola livremente. Quando você congela a primeira linha, seu cabeçalho permanece bloqueado no topo, não importa o quão longe você role os dados, semelhante ao recurso nativo de Congelar Painéis do Excel.

O seguinte trecho de código mostra como carregar um documento do Excel existente e congelar a linha superior:

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

Como Congelar a Primeira Coluna no Excel?

Para congelar a primeira coluna em vez de linhas, ajuste os parâmetros no método CreateFreezePane. Isso é útil quando sua planilha do Excel contém informações de identificação na coluna A que você deseja manter visíveis enquanto rola por colunas adicionais à direita.

O seguinte trecho de código demonstra como criar uma nova pasta de trabalho e congelar a primeira coluna:

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

Como Congelar Juntas Linhas e Colunas?

Para aplicativos que lidam com documentos Excel complexos, pode ser necessário congelar janelas que bloqueiam simultaneamente a linha superior e a primeira coluna. Isso mantém seus rótulos de cabeçalho e identificadores de linhas visíveis, não importa em qual direção você role, facilitando a compreensão e a filtragem dos dados de suas células.

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

Como Usar o Método Avançado de Congelar Painéis com Pré-Rolagem?

IronXL fornece uma opção avançada usando quatro parâmetros que permitem adicionar painéis congelados com uma posição de partida pré-rolada. Isso controla não apenas quais linhas e colunas são congeladas, mas também onde a área de rolagem começa quando os usuários abrem o arquivo pela primeira vez.

Isso é útil para dashboards ou relatórios executivos onde você deseja que a visualização inicial se posicione em uma seção específica de dados -- por exemplo, mostrando imediatamente os dados deste mês enquanto mantém a linha de cabeçalho congelada e a coluna de ID visíveis.

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

Como Remover Congelamento de Painéis de uma Planilha?

Se já existirem painéis congelados e você precisar removê-los, o método RemovePane lida com isso de maneira limpa. Isso é útil quando você precisa instalar uma configuração de congelamento diferente ou retornar a planilha ao rolagem normal.

// Remove all existing freeze or split panes
workSheet.RemovePane();

// Remove all existing freeze or split panes
workSheet.RemovePane();

Esta linha única limpa quaisquer painéis congelados existentes na planilha, permitindo que você crie uma formatação nova ou deixe o documento sem seções congeladas. Após chamar RemovePane, você pode chamar imediatamente CreateFreezePane novamente com novos parâmetros -- as duas operações se encadeiam naturalmente.

Observe que painéis congelados não funcionam com o formato Microsoft Excel 97-2003 (.xls) devido a limitações do formato de arquivo. Para melhores resultados, salve seus documentos como arquivos .xlsx. Se você encontrar um problema com arquivos baixados não exibindo painéis congelados corretamente, verifique se está usando uma versão compatível do Excel e se o arquivo está salvo no formato moderno.

Você também pode combinar a remoção de painéis congelados com outras operações na planilha. Por exemplo, antes de exportar um relatório para um layout diferente, você pode remover a configuração de congelamento, adicionar novas linhas e colunas, reestruturar os dados e então aplicar uma nova configuração de congelamento que corresponda ao layout atualizado.

Como Aplicar Painéis Congelados em Múltiplas Planilhas?

Muitos livros de trabalho Excel contêm várias planilhas -- uma por departamento, região ou período de tempo. Aplicar painéis congelados a cada planilha programaticamente economiza tempo em comparação com fazê-lo manualmente na aplicação Excel.

O seguinte exemplo carrega um livro de trabalho, itera sobre todas as planilhas e aplica a mesma configuração de congelamento a cada uma:

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

Este padrão é especialmente prático para pacotes financeiros trimestrais, onde cada planilha representa um mês, ou para relatórios de vendas multi-região, onde cada região tem sua própria aba. Combinado com ordenar dados de intervalo do Excel e aplicar formatação condicional, você pode construir livros de trabalho completamente formatados, prontos para compartilhar, inteiramente a partir do código.

IronXL também dá acesso ao modelo de objeto do WorkBook para inspeção mais detalhada do livro. Você pode verificar a contagem de planilhas, recuperar planilhas por nome ou índice, e aplicar diferentes configurações de congelamento a diferentes planilhas com base no tipo de conteúdo -- por exemplo, uma planilha de resumo pode congelar apenas a linha superior, enquanto planilhas de detalhes congelam tanto uma linha quanto uma coluna.

Como Validar Configurações de Painéis Congelados Antes de Salvar?

No código de produção é uma boa prática verificar a configuração dos painéis congelados antes de gravar o arquivo no disco. IronXL não expõe atualmente uma API de leitura para o estado dos painéis congelados diretamente, portanto, a abordagem recomendada é rastrear a configuração no seu próprio código e afirmar que a operação de salvamento é completada sem erro.

Aqui está um padrão de código defensivo que você pode aplicar em qualquer projeto .NET 10:

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

Este padrão valida parâmetros antes de chamar a API e envolve a operação de salvamento em um bloco try-catch para que quaisquer erros de sistema de arquivos ou de formato sejam capturados de forma limpa. Para geração de relatórios no lado do servidor, este tipo de código defensivo evita falhas silenciosas em pipelines de processamento em lote.

Você pode encontrar mais padrões para trabalhar com planilhas Excel e criar gráficos Excel na documentação do IronXL, que cobre toda a gama de operações de planilhas que a biblioteca suporta.

Como Combinar Painéis Congelados com Outras Funcionalidades do IronXL?

Os painéis congelados se tornam ainda mais valiosos quando combinados com outras operações de formatação e dados de planilhas. As combinações mais comuns em aplicações .NET do mundo real incluem:

Formatação de cabeçalho com painéis congelados. Congele a linha superior e aplique então formatação em negrito, cor de fundo ou estilos de borda nas células de cabeçalho para que se destaquem claramente das linhas de dados abaixo. Os usuários percebem imediatamente que a linha congelada é um cabeçalho ao invés de uma linha de dados.

Ajuste automático de larguras de coluna. Após preencher os dados, ajuste automaticamente as larguras das colunas para que cada coluna seja exatamente larga o suficiente para seu conteúdo. Isso elimina texto truncado e torna os rótulos de cabeçalho congelados legíveis à primeira vista.

Validação de dados e proteção de células. Combine painéis congelados com proteção de células para bloquear células de cabeçalho contra edição acidental. Os usuários finais podem rolar e interagir com os dados enquanto a linha de cabeçalho protegida permanece congelada e somente leitura.

Ordenação e filtragem. Aplique Excel AutoFilter à linha de cabeçalho antes de congelá-la. Quando os usuários abrem o arquivo, eles veem cabeçalhos de coluna filtráveis fixados no topo -- um padrão familiar dos aplicativos nativos do Excel.

De acordo com a documentação do Excel da Microsoft, painéis congelados são armazenados no elemento XML sheetView da planilha dentro do pacote OOXML. IronXL escreve este elemento corretamente, então os arquivos produzidos pela biblioteca abrem no Excel, LibreOffice, e Google Sheets sem configuração adicional.

O projeto Apache POI -- o equivalente em Java para manipulação do Excel -- usa a mesma especificação OOXML subjacente, então o comportamento dos painéis congelados é consistente com o que os desenvolvedores Java esperam de suas próprias ferramentas.

Quais são os seus próximos passos?

Implementar painéis congelados é uma das maneiras mais eficazes de melhorar a experiência do usuário dos seus relatórios Excel .NET. Ao travar cabeçalhos e identificadores no lugar, você transforma dados estáticos em uma ferramenta de relatório interativa que os usuários podem navegar com confiança.

Aqui está um resumo do que este guia cobriu:

• Congelamento simples de linha -- CreateFreezePane(0, 1) bloqueia a linha superior para rolagem vertical.
• Congelamento simples de coluna -- CreateFreezePane(1, 0) bloqueia a coluna mais à esquerda para rolagem horizontal.
• Congelamento combinado -- CreateFreezePane(1, 1) bloqueia tanto a linha superior quanto a primeira coluna.
• Pré-rolagem avançada -- CreateFreezePane(col, row, leftmostCol, topRow) define uma posição inicial personalizada para a tela de rolagem.
• Remover painéis -- RemovePane() limpa qualquer configuração existente de congelamento ou divisão.
• Aplicação multi-planilha -- Itera sobre workBook.WorkSheets para aplicar as mesmas configurações de congelamento em todo um livro de trabalho.

Para continuar desenvolvendo essas habilidades, explore esses guias relacionados na documentação do IronXL:

• Carregar e ler planilhas existentes
• Crie novos livros de trabalho e planilhas
• Adicione e remova linhas e colunas
• Aplique formatação e estilos às células
• Trabalhe com gráficos do Excel
• Classifique e filtre intervalos de células
• Aplique formatação condicional
• Proteja livros de trabalho e planilhas

Para uso em produção, compre uma licença para desbloquear todos os recursos e implantar com confiança. A página de licenciamento do IronXL também cobre opções de implantação, redistribuição livre de royalties e casos de uso SaaS.

!{--010011000100100101000010010100100100000101010010010110010101111101000111010001010101010100010111110101001101010100010000010101001001010100010001010100010001011111010101110100100 101010100010010000101111101010000010100100111101000100010101010100001101010100010111110101010001010010010010010010010100000101001100010111110100001001001100010011110100001101001011--}