Creación programática de documentos Word con Xceed Words para .NET en C#

Si desea crear documentos de Word mediante programación utilizando C#, Xceed Words para .NET es una API potente y fácil de usar que puede ayudarle a realizar el trabajo. En este artículo, exploraremos cómo usar Xceed Words para .NET para crear un nuevo documento Word y agregarle contenido.

Más información Xceed Words para .NET

Si desea crear documentos de Word mediante programación utilizando C#, Xceed Words para .NET es una API potente y fácil de usar que puede ayudarle a realizar el trabajo. En este artículo, exploraremos cómo usar Xceed Words para .NET para crear un nuevo documento Word y agregarle contenido.

Crear un nuevo documento de Word

Para crear un nuevo documento Word mediante programación en C# utilizando Xceed Words para .NET, basta con especificar el nombre del archivo o la ruta y el nombre del archivo, y luego guardar el documento. Este proceso puede realizarse con unas pocas líneas de código, como se muestra en el siguiente ejemplo:

// Create a new document
	using( var document = DocX.Create( "NewDocument.docx" ) )
	{
		// Save this document to disk.
		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):

// Open an existing document
	using( var document = DocX.Load( "ExistingDocument.docx" ) )
	{
		// Save this document to disk.
		document.SaveAs( "NewCopy.docx" );
	}

Notes:

  • The Create, Load and SaveAs methods expect either a String or Stream as parameter.
  • The Create method also supports an optional parameter to indicate the document type.
  • For more information please refer to the documentation.

Añadir párrafos

Un documento en blanco no es muy útil, así que añadiremos algunos párrafos.

Para añadir un párrafo hay que llamar a InsertarPárrafo en el Documento. Esto devolverá el párrafo recién creado, de modo que podamos asignarlo a una variable si pensamos hacerle alguna modificación.

// Insert a blank paragraph.
document.InsertParagraph();

// Insert a paragraph that we want to modify.
var p = document.InsertParagraph();

Una vez que tenemos un párrafo en la mano, podemos modificarlo de varias maneras. Podemos añadir elementos como texto, marcador, hipervínculo, imagen, etc. También podemos cambiar el formato, como la familia de fuentes, el tamaño de letra, el color, ponerlo en negrita/cursiva/subrayado, etc.

En esta ocasión, nos centraremos en añadir texto simple y en ver algunas formas de personalizar el aspecto del texto.

Añadir texto a un párrafo

Se puede añadir texto llamando a Añada en el párrafo. Si el texto que añadimos debe tener un aspecto determinado, también puede especificarse al mismo tiempo.

He aquí algunos ejemplos:

// Append text without any formatting
var p1 = document.InsertParagraph();
p1.Append(“This is the first paragraph.”);

// Append text formatted to be Red and Bold
var p2 = document.InsertParagraph();
p2.Append(“This is the second paragraph.”)
.Color( Color.Red )
.Bold();

// Append text formatted to be in Arial and size 24
var p3 = document.InsertParagraph();
p3.Append(“This is the third paragraph.”)
.Font( new Xceed.Document.NET.Font( "Arial" ) )
.FontSize( 24 );

También podemos añadir más de un bloque de texto al mismo tiempo y tener cada uno con su propio formato:

// Append text formatted to be Red and Bold
var p = document.InsertParagraph();
p.Append(“This is a simple formatted red bold paragraph”)
.Font( new Xceed.Document.NET.Font( "Arial" ) )
.FontSize( 24 )
.Color( Color.Red )
.Bold()
.Append(“ containing a blue italic text.”)
.Font( new Xceed.Document.NET.Font( "Times New Roman" ) )
.Color( Color.Blue )
.Italic();

Notes:

  • The Append method also supports an optional parameter to indicate the Formatting.
  • This Formatting parameter allows you to set a common format and re-use it more easily.
  • For more information please refer to the documentation.

Ahí lo tienes, tus primeros pasos en la creación de un documento Words (docx) utilizando C#. Pronto tendremos más artículos disponibles para ayudarte a aprender funcionalidades más avanzadas.

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