VB .NET Excel Congelar fila superior: mantener los encabezados visibles mientras se desplaza

¿Cómo se instala IronXL for .NET?

Antes de escribir cualquier código de congelación de paneles, añade IronXL a tu proyecto mediante el Gestor de paquetes NuGet. Abra su terminal y ejecute:

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

Alternativamente, utilice la consola del Administrador de paquetes de Visual Studio:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

Tras la instalación, añada el espacio de nombres IronXL al principio de su archivo. IronXL está optimizado for .NET 10 y es compatible con todas las plataformas principales (Windows, Linux y macOS), por lo que su lógica de congelación de paneles se ejecuta de la misma manera independientemente de dónde lo implemente.

Una vez instalado, puede cargar libros de trabajo existentes o crear otros nuevos con solo unas pocas líneas de código. La biblioteca funciona tanto con los formatos .xlsx (Excel 2007 y posteriores) como con .xls (Excel 97-2003), aunque la compatibilidad con la función "Congelar panel" requiere el formato moderno .xlsx. La tabla siguiente resume los métodos clave WorkSheet tratados en esta guía.

¿Cómo se congelan las filas en un archivo de Excel?

La respuesta es sencilla: utilice el método CreateFreezePane en su objeto de hoja de cálculo. Este método acepta parámetros que controlan qué filas y columnas permanecen visibles mientras el resto de la hoja de Excel se desplaza libremente. Cuando congela la primera fila, su encabezado permanece bloqueado en la parte superior sin importar qué tan abajo se desplace a través de los datos, similar a la función Congelar paneles nativa de Excel.

El siguiente fragmento de código muestra cómo cargar un documento de Excel existente y fijar la fila 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");

Imports IronXL
Imports System.Linq

' Load an existing workbook from file
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")
Dim workSheet As 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")

¿Cómo se fija la primera columna en Excel?

Para congelar la primera columna en lugar de las filas, ajuste los parámetros en el método CreateFreezePane. Esto es útil cuando su hoja de cálculo de Excel contiene información de identificador en la columna A que desea mantener visible mientras se desplaza por las columnas adicionales a la derecha.

El siguiente fragmento de código muestra cómo crear un nuevo libro y congelar la primera columna:

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");

Imports IronXL

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As 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")

¿Cómo se congelan las filas y las columnas a la vez?

En el caso de aplicaciones que manejan documentos de Excel complejos, es posible que sea necesario congelar paneles que bloqueen simultáneamente tanto la fila superior como la primera columna. Esto mantiene visibles las etiquetas de los encabezados y los identificadores de fila independientemente de la dirección en la que se desplace, lo que facilita la comprensión y el filtrado de los datos de las celdas.

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");

Imports IronXL

' Load workbook or create a new one
Dim workBook As WorkBook = WorkBook.Load("Inventory.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

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

' Save the document
workBook.SaveAs("Inventory_Frozen.xlsx")

¿Cómo se utiliza el método avanzado de congelar paneles con desplazamiento previo?

IronXL ofrece una opción avanzada que utiliza cuatro parámetros que le permiten agregar paneles congelados con una posición de inicio pre-desplazada. Esto controla no solo qué filas y columnas están congeladas, sino también dónde comienza el área de desplazamiento cuando los usuarios abren el archivo por primera vez.

Esto resulta útil para paneles de control o informes ejecutivos en los que se desea que la vista inicial se centre en una sección de datos específica; por ejemplo, mostrar inmediatamente los datos de este mes mientras se mantiene visible la fila de encabezado congelada y la columna de ID.

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");

Imports IronXL
Imports System.Linq

Dim workBook As WorkBook = WorkBook.Load("LargeDataset.xlsx")
Dim workSheet As 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")

¿Cómo se eliminan los paneles congelados de una hoja de cálculo?

Si ya existen paneles congelados y necesitas eliminarlos, el método RemovePane lo gestiona de forma limpia. Esto es útil cuando necesita instalar una configuración de congelación diferente o devolver la hoja al desplazamiento normal.

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

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

Esta única línea borra cualquier panel congelado que exista en la hoja de cálculo, lo que le permite crear un nuevo formato o dejar el documento sin secciones congeladas. Después de llamar a RemovePane, puedes volver a llamar inmediatamente a CreateFreezePane con nuevos parámetros; las dos operaciones se encadenan de forma natural.

Tenga en cuenta que la función "Congelar paneles" no funciona con el formato de Microsoft Excel 97-2003 (.xls) debido a limitaciones del formato de archivo. Para obtener los mejores resultados, guarde sus documentos como archivos .xlsx. Si tiene algún problema con los archivos descargados y los paneles congelados no se muestran correctamente, compruebe que está utilizando una versión compatible de Excel y que el archivo está guardado en el formato moderno.

También puede combinar la eliminación de paneles congelados con otras operaciones de la hoja de cálculo. Por ejemplo, antes de exportar un informe a un diseño diferente, es posible que elimine la configuración de congelación, añada nuevas filas y columnas, reestructure los datos y, a continuación, aplique una nueva configuración de congelación que se ajuste al diseño actualizado.

¿Cómo se aplican los paneles fijos en varias hojas de cálculo?

Muchos libros de Excel contienen varias hojas de cálculo: una por departamento, región o periodo de tiempo. Aplicar la función de congelar paneles a cada hoja mediante programación ahorra tiempo en comparación con hacerlo manualmente en la aplicación de Excel.

El siguiente ejemplo carga un libro, recorre todas las hojas de cálculo y aplica la misma configuración de congelación a cada una de ellas:

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");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("MultiSheetReport.xlsx")

' Apply freeze panes to every worksheet in the workbook
For Each sheet As WorkSheet In workBook.WorkSheets
    ' Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1)
Next

workBook.SaveAs("MultiSheetReport_Frozen.xlsx")

Este patrón resulta especialmente práctico para paquetes financieros trimestrales, en los que cada hoja representa un mes, o para informes de ventas multirregionales, en los que cada región tiene su propia pestaña. En combinación con la clasificación de datos de rangos de Excel y la aplicación de formato condicional, puedes crear libros de trabajo totalmente formateados y listos para compartir, íntegramente a partir de código.

IronXL también le da acceso al modelo de objetos WorkBook para una inspección más detallada del libro de trabajo. Puede comprobar el número de hojas, recuperar hojas por nombre o índice y aplicar diferentes configuraciones de congelación a distintas hojas en función de su tipo de contenido; por ejemplo, una hoja de resumen podría congelar solo la fila superior, mientras que las hojas de detalle congelan tanto una fila como una columna.

¿Cómo se comprueba la configuración de "Congelar panel" antes de ahorrar?

En el código de producción, es recomendable verificar la configuración del panel de congelación antes de escribir el archivo en el disco. Actualmente, IronXL no expone directamente una API de lectura del estado de congelación de paneles, por lo que el enfoque recomendado es realizar un seguimiento de la configuración en su propio código y asegurarse de que la operación de guardado se complete sin errores.

A continuación se muestra un patrón de programación defensiva que puede aplicar en cualquier proyecto de .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}");
}

Imports IronXL
Imports System

Try
    Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
    Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

    Dim freezeCol As Integer = 1
    Dim freezeRow As Integer = 1

    If freezeCol >= 0 AndAlso freezeRow >= 0 Then
        workSheet.CreateFreezePane(freezeCol, freezeRow)
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).")
    Else
        Console.WriteLine("Invalid freeze pane parameters -- skipping.")
    End If

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

Este patrón valida los parámetros antes de llamar a la API y envuelve la operación de guardado en un bloque try-catch para que cualquier error del sistema de archivos o de formato se detecte correctamente. Para la generación de informes del lado del servidor, este tipo de código defensivo evita fallos silenciosos en los procesos de procesamiento por lotes.

Puede encontrar más patrones para trabajar con hojas de cálculo de Excel y crear gráficos de Excel en la documentación de IronXL, que cubre toda la gama de operaciones de hojas de cálculo que admite la biblioteca IronXL.

¿Cómo se combina la función "Congelar paneles" con otras funciones de IronXL?

La función de congelar paneles resulta aún más valiosa cuando se combina con otras operaciones de formato y de datos de la hoja de cálculo. Las combinaciones más comunes en aplicaciones .NET reales incluyen:

Formato de encabezado con paneles fijos. Fije la fila superior y, a continuación, aplique formato en negrita, color de fondo o estilos de borde a las celdas del encabezado para que destaquen claramente de las filas de datos que hay debajo. Los usuarios se dan cuenta inmediatamente de que la fila congelada es un encabezado y no una fila de datos.

Ajustar automáticamente el ancho de las columnas. Tras introducir los datos, ajuste automáticamente el ancho de las columnas para que cada una tenga el ancho exacto necesario para su contenido. Esto elimina el texto truncado y hace que las etiquetas de los encabezados fijos sean legibles de un vistazo.

Validación de datos y protección de celdas. Combine la función de congelar paneles con la protección de celdas para bloquear las celdas de encabezado y evitar su edición accidental. Los usuarios finales pueden desplazarse e interactuar con los datos, mientras que la fila de encabezado protegida permanece fija y es de solo lectura.

Ordenar y filtrar. Aplica el filtro automático de Excel a la fila de encabezado antes de congelarla. Cuando los usuarios abren el archivo, ven encabezados de columna filtrables fijados en la parte superior, un patrón familiar de las aplicaciones nativas de Excel.

Según la documentación de Excel de Microsoft, los paneles congelados se almacenan en el elemento XML sheetView de la hoja de cálculo dentro del paquete OOXML. IronXL escribe este elemento correctamente, por lo que los archivos generados por la biblioteca IronXL se abren en Excel, LibreOffice y Google Sheets sin necesidad de configuración adicional.

El proyecto Apache POI —el equivalente en Java para la manipulación de Excel— utiliza la misma especificación OOXML subyacente, por lo que el comportamiento de la función "congelar panel" es coherente con lo que los desarrolladores de Java esperan de sus propias herramientas.

¿Cuales son tus próximos pasos?

La implementación de paneles congelados es una de las formas más efectivas de mejorar la experiencia del usuario de sus informes .NET Excel. Al bloquear los encabezados e identificadores en su lugar, transforma los datos estáticos en una herramienta de informes interactivos que los usuarios pueden navegar con confianza.

A continuación se ofrece un resumen de lo que se ha tratado en esta guía:

• Congelación simple de fila -- CreateFreezePane(0, 1) bloquea la fila superior para el desplazamiento vertical.
• Congelación simple de columnas -- CreateFreezePane(1, 0) bloquea la columna más a la izquierda para el desplazamiento horizontal.
• Congelación combinada -- CreateFreezePane(1, 1) bloquea tanto la fila superior como la primera columna.
• Desplazamiento previo avanzado -- CreateFreezePane(col, row, leftmostCol, topRow) establece una posición inicial personalizada para el panel de desplazamiento.
• Eliminar paneles -- RemovePane() borra cualquier configuración de congelación o división existente.
• Aplicación de varias hojas: itera sobre workBook.WorkSheets para aplicar la misma configuración de congelación en todo el libro.

Para seguir desarrollando estas habilidades, consulta estas guías relacionadas en la documentación de IronXL:

• Cargar y leer hojas de cálculo existentes
• Crear nuevos libros y hojas de cálculo
• Añadir y eliminar filas y columnas
• Aplicar formato y estilos a las celdas
• Trabajar con gráficos de Excel
• Ordenar y filtrar rangos de celdas
• Aplicar formato condicional
• Proteger libros y hojas de cálculo

Para uso en producción, adquiere una licencia para desbloquear todas las funciones e implementarlas con confianza. La página de licencias de IronXL también aborda las opciones de implementación, la redistribución libre de regalías y los casos de uso de SaaS.

Empiece con IronXL ahora.

Comience gratis