Escribir funciones .NET de Excel
Muchos proyectos de aplicaciones C# requieren que actualicemos archivos y escribamos nuevos datos en Hojas de Cálculo Excel mediante programación. Las capacidades de Excel .NET a veces pueden ser complicadas, pero utilizando la librería IronXL, esta tarea es bastante sencilla y permite trabajar con Hojas de Cálculo Excel en cualquier formato. Sin grandes líneas de código, sólo acceso a las celdas específicas y a los valores personalizados que asignes.
Comienza con IronXL
Comience a usar IronXL en su proyecto hoy con una prueba gratuita.
Acceso a archivos Excel
Empecemos por acceder al fichero Excel en el que queremos escribir los datos. Abramos el archivo Excel en nuestro proyecto, y luego abramos su Hoja de Trabajo específica, usando el siguiente código.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-load-file.cs
// Load Excel file in the project
WorkBook workBook = WorkBook.Load("path");
' Load Excel file in the project
Dim workBook As WorkBook = WorkBook.Load("path")
Lo anterior abrirá el archivo Excel especificado. A continuación, la Hoja de cálculo.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-get-sheet.cs
// Open Excel WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
' Open Excel WorkSheet
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
El Excel WorkSheet se abrirá en workSheet
y podemos usarlo para escribir cualquier tipo de datos en un archivo Excel. Más información sobre cómocargar archivo Excel tipos y acceder a las hojas de trabajo de diferentes maneras a través de los ejemplos del enlace. Nota: No olvides añadir la referencia de IronXL
en tu proyecto e importar la librería mediante Using IronXL
.
Escribir valor en celda específica
Podemos escribir en un fichero Excel utilizando muchos métodos diferentes, pero el enfoque básico es utilizar Celda Excel
. Para ello, se puede acceder a cualquier celda de la hoja de Excel abierta y escribir un valor en ella de la siguiente manera:
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-cell.cs
workSheet["Cell Address"].Value="Assign the Value";
workSheet("Cell Address").Value="Assign the Value"
He aquí un ejemplo de cómo utilizar la función anterior para escribir en una celda de Excel en nuestro proyecto C#.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-cell-full.cs
using IronXL;
// Load Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
// Open WorkSheet of sample.xlsx
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
// Access A1 cell and write the value
workSheet["A1"].Value = "new value";
// Save changes
workBook.SaveAs("sample.xlsx");
Imports IronXL
' Load Excel file
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
' Open WorkSheet of sample.xlsx
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
' Access A1 cell and write the value
Private workSheet("A1").Value = "new value"
' Save changes
workBook.SaveAs("sample.xlsx")
Este código escribirá el nuevo valor
en la celda A1
de la Hoja de Trabajo Hoja1
en el fichero Excel sample.xlsx
. Del mismo modo, podemos insertar valores en cualquier dirección de celda de un fichero Excel. Nota: No olvide guardar el archivo Excel después de escribir nuevos valores en la Hoja de Trabajo, como se muestra en el ejemplo anterior.
Forzar la asignación del valor exacto
Al establecer la propiedad Value, IronXL intentaría convertirla a su tipo de valor correspondiente. A veces, esta evaluación no es deseable ya que el usuario quiere forzar la asignación del valor exacto a la celda y no el convertido. La forma de hacerlo es asignar el valor como una cadena. Esto puede hacerse colocando un apóstrofo delante del valor de una celda en Excel. En IronXL, simplemente use StringValue en lugar de Value para lograr lo mismo.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs
// Assign value as string
workSheet["A1"].StringValue = "4402-12";
' Assign value as string
workSheet("A1").StringValue = "4402-12"
Escribir valores estáticos en un intervalo
Podemos escribir nuevos valores en múltiples celdas, llamadas Rango, de la siguiente manera:
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-cell-range.cs
workSheet["From Cell Address:To Cell Address"].Value = "New Value";
workSheet("From Cell Address:To Cell Address").Value = "New Value"
De esta forma, especificamos el rango de celdas Desde
hasta Hasta
donde se escribirán los datos. Después de esto, se escribirá Nuevo Valor
en todas las celdas que se encuentren en este rango. Comprender mejorC# Excel Rango consulte los ejemplos aquí.
Veamos cómo escribir un rango en acción utilizando el siguiente ejemplo.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-cell-range-full.cs
using IronXL;
// Load Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
// Open WorkSheet of sample.xlsx
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
// Specify range row wise and write new value
workSheet["B2:B9"].Value = "new value";
// Specify range column wise and write new value
workSheet["C3:C7"].Value = "new value";
// Save changes
workBook.SaveAs("sample.xlsx");
Imports IronXL
' Load Excel file
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
' Open WorkSheet of sample.xlsx
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
' Specify range row wise and write new value
Private workSheet("B2:B9").Value = "new value"
' Specify range column wise and write new value
Private workSheet("C3:C7").Value = "new value"
' Save changes
workBook.SaveAs("sample.xlsx")
Este código escribirá el nuevo valor
de B2
a B9
.(Gama Row Wise) y de C3
a C7
(Gama por columnas) de la hoja de trabajo sheet1
del archivo Excel sample.xlsx
. Utilizaba valores estáticos para las celdas de Excel.
Escribir valores dinámicos en un intervalo
También podemos añadir valores dinámicos a un rango, como se ve a continuación.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-dynamic-value.cs
using IronXL;
// Load Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
// Open WorkSheet of sample.xlsx
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
// Specify range in which we want to write the values
for (int i = 2; i <= 7; i++)
{
// Write the Dynamic value in one row
workSheet["B" + i].Value = "Value" + i;
// Write the Dynamic value in another row
workSheet["D" + i].Value = "Value" + i;
}
// Save changes
workBook.SaveAs("sample.xlsx");
Imports IronXL
' Load Excel file
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
' Open WorkSheet of sample.xlsx
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
' Specify range in which we want to write the values
For i As Integer = 2 To 7
' Write the Dynamic value in one row
workSheet("B" & i).Value = "Value" & i
' Write the Dynamic value in another row
workSheet("D" & i).Value = "Value" & i
Next i
' Save changes
workBook.SaveAs("sample.xlsx")
El código anterior escribirá valores dinámicos en las columnas B
y D
desde 2
hasta 7
en el fichero Excel sample.xlsx
. Podemos ver el resultado del código en sample.xlsx
:
Reemplazar valor de celda Excel
Usando IronXL, podemos escribir fácilmente un nuevo valor para reemplazar el valor anterior, usando la función Replace()
funcionan de la siguiente manera:
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-replace.cs
workSheet.Replace("old value", "new value");
workSheet.Replace("old value", "new value")
La función anterior escribirá el nuevo valor
sobreescribiendo el viejo valor
en toda la hoja de Excel.
Reemplazar valor de celda en fila específica
Si queremos escribir un nuevo valor sólo en una fila específica, entonces se puede hacer de la siguiente manera:
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-replace-row.cs
workSheet.Rows[RowIndex].Replace("old value", "new value");
workSheet.Rows(RowIndex).Replace("old value", "new value")
Esto escribirá el nuevo valor
sobre el viejo valor
sólo en el índice de fila especificado.
Reemplazar valor de celda en columna específica
De la misma manera, si queremos escribir un nuevo valor
sobre el viejo valor
dentro de una columna específica, entonces se puede hacer de la siguiente manera:
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-replace-column.cs
workSheet.Columns[ColumnIndex].Replace("old value", "new Value");
workSheet.Columns(ColumnIndex).Replace("old value", "new Value")
El código anterior escribirá el nuevo valor
para reemplazar al viejo valor
, pero sólo en el índice de columna especificado. El resto de la Hoja de Trabajo permanece igual.
Reemplazar valor de celda en rango específico
IronXL también provee una forma de escribir un nuevo valor
reemplazando al viejo valor
, sólo en un rango específico.
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-replace-range.cs
workSheet["From Cell Address : To Cell Address"].Replace("old value", "new value");
workSheet("From Cell Address : To Cell Address").Replace("old value", "new value")
Esto escribirá el nuevo valor
por encima del viejo valor
, sólo en las celdas que se encuentren en el rango especificado.
Veamos el ejemplo de cómo utilizar todas las funciones anteriores para escribir nuevos valores que sustituyan a los antiguos en una Hoja de Trabajo de Excel.
Ejemplo de todas las funciones
:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-replace-full.cs
using IronXL;
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
// Write new above old in complete WorkSheet
workSheet.Replace("old", "new");
// Write new above old just in row no 6 of WorkSheet
workSheet.Rows[5].Replace("old", "new");
// Write new above old just in column no 5 of WorkSheet
workSheet.Columns[4].Replace("old", "new");
// Write new above old just from A5 to H5 of WorkSheet
workSheet["A5:H5"].Replace("old", "new");
workBook.SaveAs("sample.xlsx");
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("sample.xlsx")
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")
' Write new above old in complete WorkSheet
workSheet.Replace("old", "new")
' Write new above old just in row no 6 of WorkSheet
workSheet.Rows(5).Replace("old", "new")
' Write new above old just in column no 5 of WorkSheet
workSheet.Columns(4).Replace("old", "new")
' Write new above old just from A5 to H5 of WorkSheet
workSheet("A5:H5").Replace("old", "new")
workBook.SaveAs("sample.xlsx")
Para obtener más información sobre cómo escribir aplicaciones Excel .NET y mucho más, consulte nuestro tutorial completo sobre cómoAbrir y escribir archivos Excel C#.
Acceso rápido a tutoriales
Leer la referencia de la API
Lea la documentación de IronXL que incluye listas de todas las funciones, características, espacios de nombres, clases y enums disponibles para usted en la biblioteca.
Leer la referencia de la API