Cómo cargar hojas de cálculo existentes en C#
Cargue archivos Excel, CSV, TSV y objetos DataSet existentes en hojas de cálculo de C# mediante el método WorkBook.Load() de IronXL para una compatibilidad total con Excel o LoadCSV() para formatos CSV, lo que permite manipular y extraer datos sin problemas en aplicaciones .NET.
El formato de archivo CSV (Comma-Separated Values) es para datos tabulares donde los valores están separados por comas, comúnmente usado para el intercambio de datos. TSV (Tab-Separated Values) utiliza tabulaciones para separar valores, preferentemente cuando los datos contienen comas. Más información sobre la conversión entre formatos de archivo.
La clase DataSet de .NET de Microsoft forma parte de la tecnología ADO.NET (ActiveX Data Objects for .NET). Se usa a menudo en aplicaciones relacionadas con bases de datos y te permite trabajar con datos de varias fuentes como bases de datos, XML y más. IronXL proporciona una integración perfecta para importar y exportar objetos DataSet.
Los datos contenidos en formatos de archivo de Excel como XLSX, XLS, XLSM, XLTX, CSV y TSV, así como los objetos DataSet pueden cargarse en una hoja de cálculo de Excel utilizando IronXL. Esta potente capacidad convierte a IronXL en una herramienta esencial para los desarrolladores que trabajan con datos de hojas de cálculo en aplicaciones empresariales, proyectos de análisis de datos y sistemas de informes automatizados.
como-encabezado:2(Inicio rápido: cargar una hoja de cálculo existente)
Usando un método simple, puedes cargar un archivo existente de Excel, CSV o TSV en un WorkBook con IronXL. Los desarrolladores pueden comenzar rápidamente a editar o extraer datos llamando a WorkBook.Load(...) para soporte completo de Excel, o LoadCSV(...) específicamente para formatos CSV. Para obtener una documentación completa de la API, visite Referencia de la API de IronXL.
Empieza a crear PDF con NuGet ahora:
Instalar IronXL con el gestor de paquetes NuGet
Copie y ejecute este fragmento de código.
IronXL.WorkBook workbook = IronXL.WorkBook.Load("sample.xlsx");Despliegue para probar en su entorno real
Empieza a utilizar IronXL en tu proyecto hoy mismo con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca C# para cargar la hoja de cálculo
- Prepara el archivo u objeto de datos para ser cargado en la hoja de cálculo
- Utilice el método
Loadpara cargar los datos en un objeto de libro de trabajo - Utilice el método
LoadWorkSheetsFromDataSetpara cargar datos desde un objeto DataSet - Exporta el libro como un archivo de Excel
¿Cómo cargar archivos de hoja de cálculo de Excel en C#?
Usa el método estático Load para cargar un libro de trabajo de Excel existente. El método admite los formatos de archivo XLSX, XLS, XLSM, XLTX, CSV y TSV. Si el libro de trabajo está protegido con una contraseña, pásela como segundo parámetro del método. El método también acepta datos del libro de trabajo como una matriz de bytes o un flujo, donde se pueden utilizar los métodos dedicados FromByteArray y FromStream, respectivamente.
Las capacidades de carga de IronXL están diseñadas para manejar diversos escenarios en aplicaciones del mundo real. Tanto si se procesan archivos subidos por los usuarios, como si se leen flujos de red o se trabaja con documentos cifrados, la biblioteca ofrece una interfaz coherente y fiable. El método Load detecta automáticamente el formato del archivo basándose en su extensión y contenido, lo que lo hace versátil para diferentes casos de uso.
¿Qué formatos de archivo puedo cargar?
:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-spreadsheet.csusing IronXL;
// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");Imports IronXL
' Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")La flexibilidad para cargar varios formatos de archivo permite trabajar con archivos de Excel heredados (XLS), libros de Excel modernos (XLSX), libros habilitados para macros (XLSM) y archivos de plantilla (XLTX). Esta compatibilidad garantiza una migración fluida desde sistemas antiguos al tiempo que admite las funciones modernas de Excel. Para obtener más información sobre creación de nuevas hojas de cálculo, consulta nuestra guía completa.
¿Cómo manejo archivos protegidos por contraseña?
El trabajo con datos confidenciales suele requerir la protección mediante contraseña. IronXL hace que sea sencillo cargar libros de trabajo protegidos por contraseña proporcionando la contraseña como parámetro:
// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");
// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";
// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");
// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";
// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");IRON VB CONVERTER ERROR developers@ironsoftware.com¿Qué pasa con la carga desde matrices de bytes o flujos?
En las aplicaciones modernas, los archivos suelen proceder de diversas fuentes, como cargas web, respuestas de API o BLOB de bases de datos. IronXL maneja estos escenarios con elegancia:
// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);
// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
WorkBook workBookFromStream = WorkBook.FromStream(stream);
// Process the workbook
var sheet = workBookFromStream.DefaultWorkSheet;
Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}
// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);
// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
WorkBook workBookFromStream = WorkBook.FromStream(stream);
// Process the workbook
var sheet = workBookFromStream.DefaultWorkSheet;
Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}
// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}IRON VB CONVERTER ERROR developers@ironsoftware.com¿Por qué debería utilizar un método específico para archivos CSV?
Aunque el método Load puede leer todos los formatos de archivo disponibles, utilice el método LoadCSV específicamente para formatos de archivo CSV para un manejo óptimo. Los archivos CSV tienen características únicas que se benefician de un procesamiento especializado, como la detección de delimitadores, la gestión de la codificación y la inferencia de tipos de datos. Resulta especialmente útil cuando se trabaja con formatos de datos internacionales o cuando los archivos CSV utilizan delimitadores no estándar, como punto y coma o tuberías.
¿Cuándo es mejor LoadCSV que Load?
El método LoadCSV proporciona un mayor control sobre el análisis sintáctico de CSV, por lo que es ideal cuando se necesita especificar delimitadores personalizados, manejar diferentes codificaciones o trabajar con archivos CSV de gran tamaño. Resulta especialmente útil cuando se trabaja con formatos de datos internacionales o cuando los archivos CSV utilizan delimitadores no estándar, como punto y coma o tuberías.
¿Cómo maneja LoadCSV los caracteres especiales?
:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-csv.csusing IronXL;
// Load CSV file
WorkBook workBook = WorkBook.LoadCSV("sample.csv");Imports IronXL
' Load CSV file
Private workBook As WorkBook = WorkBook.LoadCSV("sample.csv")El método LoadCSV maneja automáticamente varias codificaciones, como UTF-8, UTF-16 y ASCII, y garantiza que los caracteres especiales, las letras acentuadas y los símbolos internacionales se conserven correctamente. Esto es crucial cuando se trabaja con datos multilingües o notación científica. Más información sobre escritura de archivos CSV en .NET para una gestión completa del flujo de trabajo CSV.
¿Cómo puedo cargar objetos DataSet en Excel?
La clase DataSet en Microsoft .NET se utiliza para gestionar y trabajar con datos en una representación desconectada en memoria. Este DataSet puede cargarse en el libro de trabajo utilizando el método LoadWorkSheetsFromDataSet. En el ejemplo de código a continuación, se crea un DataSet vacío; sin embargo, es más común instanciar el DataSet a partir de una consulta de base de datos.
¿Por qué debería convertir DataSet a Excel?
La conversión de objetos DataSet a formato Excel es esencial para la elaboración de informes, la exportación de datos y la creación de presentaciones de datos fáciles de usar. Los usuarios empresariales suelen preferir los formatos de Excel para el análisis de datos, y los informes automatizados a menudo necesitan transformar los resultados de las bases de datos en formatos de hoja de cálculo. Esta conversión permite funciones como formateo condicional, creación de gráficos y aplicación de fórmulas que no están disponibles en los objetos DataSet sin procesar.
¿Qué ocurre con las relaciones DataSet en Excel?
Al cargar un DataSet con múltiples tablas relacionadas, IronXL crea hojas de trabajo separadas para cada DataTable en el DataSet. Las relaciones entre tablas se conservan mediante valores clave coherentes, lo que permite a los usuarios mantener la integridad de los datos al trabajar con el archivo Excel exportado. Esto lo hace ideal para exportar esquemas de bases de datos complejos manteniendo la integridad referencial.
¿Puedo cargar varias tablas desde un conjunto de datos?
:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-dataset.csusing IronXL;
using System.Data;
// Create dataset
DataSet dataSet = new DataSet();
// Create workbook
WorkBook workBook = WorkBook.Create();
// Load DataSet
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);Imports IronXL
Imports System.Data
' Create dataset
Private dataSet As New DataSet()
' Create workbook
Private workBook As WorkBook = WorkBook.Create()
' Load DataSet
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook)Para escenarios más avanzados que impliquen la integración de bases de datos, explore nuestra guía sobre Excel to SQL via System.Data.DataSet que demuestra el flujo de datos bidireccional entre Excel y las bases de datos.
La capacidad de cargar varias fuentes de datos en formato Excel convierte a IronXL en una herramienta inestimable para los desarrolladores .NET. Tanto si estás creando sistemas de informes, herramientas de migración de datos o aplicaciones de inteligencia empresarial, las capacidades de carga proporcionan la base para una potente manipulación de hojas de cálculo. Para más ejemplos y técnicas avanzadas, visite nuestra sección de tutoriales.
Preguntas Frecuentes
¿Qué formatos de archivo puedo cargar en las hojas de cálculo de C#?
IronXL admite la carga de varios formatos de archivo, incluidos archivos XLSX, XLS, XLSM, XLTX, CSV y TSV, así como objetos DataSet. Este amplio soporte de formatos hace que IronXL sea adecuado para diversas necesidades de manipulación de datos de hojas de cálculo en aplicaciones .NET.
¿Cómo se carga un archivo Excel en C#?
Puede cargar un archivo de Excel utilizando el método WorkBook.Load() de IronXL con sólo una línea de código: IronXL.WorkBook workbook = IronXL.WorkBook.Load("sample.xlsx"). Para archivos CSV específicamente, puedes usar el método LoadCSV().
¿Puedo cargar archivos Excel protegidos por contraseña?
Sí, IronXL admite la carga de libros de trabajo protegidos por contraseña. Simplemente pase la contraseña como el segundo parámetro al método Cargar al abrir archivos de Excel cifrados.
¿Cuál es la diferencia entre los formatos de archivo CSV y TSV?
CSV (Comma-Separated Values) utiliza comas para separar valores y se utiliza habitualmente para el intercambio de datos. TSV (Tab-Separated Values) utiliza tabulaciones en su lugar, lo cual es preferible cuando sus datos contienen comas. IronXL soporta la carga de ambos formatos sin problemas.
¿Puedo cargar datos de Excel desde otras fuentes que no sean archivos?
Sí, IronXL puede cargar datos de libros de trabajo desde múltiples fuentes, incluidas matrices de bytes utilizando el método FromByteArray y flujos utilizando el método FromStream. Esta flexibilidad permite procesar archivos desde cargas, flujos de red o memoria.
¿Cómo se trabaja con objetos DataSet en hojas de cálculo?
IronXL proporciona el método LoadWorkSheetsFromDataSet para importar datos de objetos ADO.NET DataSet a hojas de cálculo Excel. Esta integración permite la transferencia de datos sin problemas entre aplicaciones de bases de datos y libros de Excel.
¿Cuáles son los principales pasos para cargar y exportar datos de una hoja de cálculo?
El flujo de trabajo implica: 1) Descargar la biblioteca IronXL, 2) Preparar su archivo o DataSet, 3) Utilizar el método Load para crear un objeto de libro de trabajo, 4) Utilizar LoadWorkSheetsFromDataSet para las importaciones DataSet, y 5) Exportar el libro de trabajo según sea necesario.
¿Existe documentación completa sobre los métodos de carga?
Sí, IronXL proporciona documentación completa de la API, incluida información detallada sobre todos los métodos de carga y sus parámetros en la Referencia de la API de IronXL, lo que ayuda a los desarrolladores a implementar la funcionalidad de carga de hojas de cálculo de manera efectiva.






