Más información Cuadernos Xeed para .NET

¡Bienvenidos a una nueva serie! Esta vez repasaremos la última incorporación a la colección Xceed: Workbooks para .NET

En primer lugar, empezaremos con lo básico sobre cómo crear un documento y aprenderemos temas más avanzados a medida que avancemos en los próximos artículos.

¿Qué es este nuevo Workbooks para .NET?

Xceed Workbooks for .NET es una forma rápida y ligera de crear o manipular documentos de Microsoft Excel desde sus aplicaciones .NET, sin necesidad de tener instalado Excel u Office.

Con su API fácil de usar, Xceed Workbooks para .NET permite a su aplicación crear o modificar documentos Microsoft Exccel .xlsx y le da un control completo sobre el contenido de estos documentos. Le permite modificar el contenido de las Celdas, redimensionar Columnas y Filas, crear Tablas formateadas y mucho más.

También puede ser una gran herramienta de elaboración de informes, por ejemplo, creando informes de empresa y utilizándolos después como plantilla que se personaliza mediante programación antes de enviar cada informe.

Xceed Workbooks for .NET puede utilizarse para crear facturas mediante programación, añadir datos a documentos, realizar cálculos con fórmulas, etc.

Cómo empezar

¡Vamos a crear nuestro primer proyecto!

Primer paso, asegúrate de que recuerdas añadir la sentencia using:

using Xceed.Workbooks.NET;

Si utiliza .NET Core, .NET 5 y posteriores, tendrá que activar manualmente el producto, pero no se preocupe, es un proceso muy sencillo. Para ello, asegúrese de tener a mano la clave de licencia.

Si está utilizando una aplicación de consola, simplemente añada la siguiente declaración en el módulo principal:

Xceed.Workbooks.NET.Licenser.LicenseKey = "Your-License-Key";

En una aplicación Winforms o WPF, es necesario establecerlo antes de la sentencia InitializeComponent();, por lo que tendrá el siguiente aspecto:

Xceed.Workbooks.NET.Licenser.LicenseKey = "Your-License-Key";
InitializeComponent();

A continuación, vamos a ver cómo crear simplemente un documento en blanco. Todo lo que necesitamos es especificar el nombre del archivo (o la ruta y el nombre del archivo) y, a continuación, guardar el documento.

// Create a new document as a file
using( var document = Workbook.Create( "NewDocument.xlsx" ) )
{
	// Save the workbook to the file.
	document.Save();
}

Otra opción es guardar el documento en un stream:

// Create a new document as a stream
var stream = new MemoryStream();
using( var document = Workbook.Create( stream ) )
{
	// Save the workbook in the stream.
	document.Save();
}

También podemos abrir un documento existente en lugar de crear uno nuevo (utilizando Carga en lugar de Cree), y podemos elegir guardar en un nuevo documento en lugar de sobrescribir el existente (utilizando Guardar como en lugar de Ahorra). El documento a abrir puede ser de un archivo o de un flujo, y la nueva copia también puede guardarse en un nuevo archivo o en un flujo.

// Open an existing document from a file
using( var document = Workbook.Load( "ExistingDocument.xlsx" ) )
{
	// Save this document to disk to a new file.
	document.SaveAs( "NewCopy.docx" );
	// Save this document to a stream instead
	var stream = new MemoryStream();
	document.SaveAs( stream );
}

// Open an existing document from a stream
using( var document = Workbook.Load( existingStream ) )
{
	// Save this document to disk to a new file.
	document.SaveAs( "NewCopy.docx" );
	// Save this document to a stream instead
	var stream = new MemoryStream();
	document.SaveAs( stream );
}

Notes:

• The Create, Load and SaveAs methods all expect either a String or Stream as parameter.

Añadir y recuperar hojas de cálculo

Un documento en blanco no es muy útil, pero antes de ver cómo añadir contenido a una Hoja de Cálculo, veamos cómo podemos añadir Hojas de Cálculo u obtener una específica de nuestro documento.

Note:

• A Workbook will always have a Worksheet by default, whether it is created or loaded.

Para añadir una nueva hoja de cálculo se llama a la función Añadir en el Hojas de trabajo del documento; en este momento también se puede especificar el nombre de la hoja de cálculo.

// Insert a new worksheet.
document.Worksheets.Add();

// Insert a new worksheet named "Tests"
document.Worksheets.Add("Tests");

Para buscar un Hoja de trabajo en un documento, utilizamos la función Hojas de trabajo y especificar el índice basado en 0 o el nombre de la hoja que queremos.

// Get the 2nd worksheet
var worksheetA = document.Worksheets[ 1 ];

// Get the worksheet named "Tests"
var worksheetB = document.Worksheets[ "Tests" ];

También podemos comprobar primero si existe una hoja de cálculo específica utilizando la función Contiene en el Hojas de trabajo colección.

// Verify if a worksheet named "Tests" exists in the document
if ( document.Worksheets.Contains( "Tests" ) )
{
	Debug.WriteLine( "Worksheet Found" );
}

¡Ahí lo tienes! Tus primeros pasos en la creación de un documento Workbooks (xlsx) utilizando C#. El siguiente paso será añadir y modificar su contenido. Empezaremos a cubrir esto en nuestro próximo artículo. ¡Hasta entonces!

Para más información, consulte el documentación.