Ícono de mensaje
Saltar al pie de página
  1. IronWord
  2. Blog de IronWord
  3. Usando IronWord
  4. Imprimir Word en C# (Tutorial para desarrolladores)
USANDO IRONWORD

C# Imprimir Word Tutorial: Guía Paso a Paso

Jordi Bardia
Jordi Bardia
Actualizado:

Bienvenido a este tutorial, donde exploraremos cómo imprimir documentos de Word usando Microsoft Interop en una aplicación de consola C#. Esta guía para principiantes te guiará a través de los pasos para imprimir documentos de Microsoft Word programáticamente.

Requisitos previos

Antes de sumergirte en el código, es esencial tener algunas cosas preparadas:

  • Instalación de Microsoft Word: Asegúrate de tener Microsoft Word instalado en tu sistema. Si no, ve al sitio web oficial de Microsoft en tu computadora o a la tienda de aplicaciones para instalarlo.

  • Configuración de Visual Studio: Deberías tener Visual Studio instalado con la capacidad de crear una aplicación de consola. Si eres un principiante, considera descargar Visual Studio Community, que es gratuito y suficiente para nuestras necesidades.

  • Un Documento de Word: Ten un documento de Word de muestra listo en tu máquina para propósitos de prueba. Este será el documento que enviaremos a la impresora.

Configuración del entorno

Crear una nueva aplicación de consola

  1. Abre Visual Studio.
  2. Haz clic en "Crear un nuevo proyecto".
  3. Busca "App de Consola" y selecciona la plantilla de C# apropiada.
  4. Nombra tu proyecto (por ejemplo, "InteropPrintConsoleTutorial") y elige una ubicación adecuada.

Agregar referencia de interoperabilidad

Usar Interop requiere una referencia a la biblioteca Microsoft Office Interop. Aquí se muestra cómo agregarla:

  1. En Visual Studio, haz clic derecho en tu proyecto de consola en el Explorador de Soluciones.
  2. Navega hasta Agregar > Referencia.
  3. En la ventana del Administrador de Referencias, ve a la pestaña COM.
  4. Escribe "Microsoft Word" en la barra de búsqueda para filtrar la lista.
  5. De los resultados, selecciona "Microsoft Word xx.x Object Library" (donde xx.x denota el número de versión).
  6. Haz clic en el botón OK para agregar la referencia.

También puedes instalarla usando el Administrador de Paquetes NuGet.

También puedes instalar la biblioteca `Microsoft.Office.Interop.Word` usando el Administrador de Paquetes NuGet.

Verificar la configuración de la aplicación

Asegúrate de que el marco de trabajo de destino de tu aplicación sea compatible con la biblioteca Interop. Puedes verificar esto haciendo clic derecho en tu proyecto en el Explorador de Soluciones, seleccionando Propiedades, y luego viendo el Marco de Trabajo de Destino en la pestaña Aplicación. Si te enfrentas a problemas con la versión de la biblioteca Interop, considera descargar el paquete o ensamblado necesario o ajustar la versión del marco de trabajo de destino.

Con el entorno configurado, ahora puedes proceder con el proceso de codificación.

Comprensión del objeto Documento

El objeto de documento está en el corazón de los servicios Interop cuando se trata de documentos de Word. Este objeto representa un documento de Microsoft Word y proporciona todas sus funcionalidades.

Una tarea común es abrir un documento:

using Word = Microsoft.Office.Interop.Word;

// Object needed to avoid passing specific parameters
object oMissing = Type.Missing;

// File path to the Word document you want to open
object fileName = @"C:\path_to_document\document.docx";

// Create a new instance of the Word application
Word.Application wordApp = new Word.Application();

// Open the document with specified parameters
Word._Document wordDoc = wordApp.Documents.Open(
    ref fileName, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing);
using Word = Microsoft.Office.Interop.Word;

// Object needed to avoid passing specific parameters
object oMissing = Type.Missing;

// File path to the Word document you want to open
object fileName = @"C:\path_to_document\document.docx";

// Create a new instance of the Word application
Word.Application wordApp = new Word.Application();

// Open the document with specified parameters
Word._Document wordDoc = wordApp.Documents.Open(
    ref fileName, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing);
Imports Word = Microsoft.Office.Interop.Word

' Object needed to avoid passing specific parameters
Private oMissing As Object = Type.Missing

' File path to the Word document you want to open
Private fileName As Object = "C:\path_to_document\document.docx"

' Create a new instance of the Word application
Private wordApp As New Word.Application()

' Open the document with specified parameters
Private wordDoc As Word._Document = wordApp.Documents.Open(fileName, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing)
$vbLabelText   $csharpLabel

Los múltiples parámetros con ref oMissing pueden parecer abrumadores, pero son esenciales para el método Open, que espera numerosos argumentos, la mayoría de los cuales son opcionales.

Implementación de la funcionalidad de impresión

Con nuestro entorno configurado y entendiendo el objeto de documento, es hora de sumergirse en la funcionalidad central de imprimir documentos de Word.

Impresión básica de documentos de Word

Para imprimir el documento, puedes usar el siguiente método:

// Method to print the document using default printer settings
private void ButtonPrint_Click(object sender, EventArgs e)
{
    wordDoc.PrintOut(); // Sends the document to the default printer
}
// Method to print the document using default printer settings
private void ButtonPrint_Click(object sender, EventArgs e)
{
    wordDoc.PrintOut(); // Sends the document to the default printer
}
' Method to print the document using default printer settings
Private Sub ButtonPrint_Click(ByVal sender As Object, ByVal e As EventArgs)
	wordDoc.PrintOut() ' Sends the document to the default printer
End Sub
$vbLabelText   $csharpLabel

Este método envía el documento a la impresora predeterminada usando la configuración predeterminada.

Imprimir documentos de Word con personalizaciones

Si deseas introducir un cuadro de diálogo de impresión, personalizar la configuración de la impresora, o incluso imprimir varias páginas, necesitarás un enfoque más detallado:

// Method to print the document with custom settings
private void ButtonPrintWithSettings_Click(object sender, EventArgs e)
{
    // Number of copies to print
    object copies = "1";

    // Page range to print, e.g., pages 1 to 3
    object pages = "1-3";

    // Print the document with specified copies and page range
    wordDoc.PrintOut(Copies: ref copies, Pages: ref pages);
}
// Method to print the document with custom settings
private void ButtonPrintWithSettings_Click(object sender, EventArgs e)
{
    // Number of copies to print
    object copies = "1";

    // Page range to print, e.g., pages 1 to 3
    object pages = "1-3";

    // Print the document with specified copies and page range
    wordDoc.PrintOut(Copies: ref copies, Pages: ref pages);
}
' Method to print the document with custom settings
Private Sub ButtonPrintWithSettings_Click(ByVal sender As Object, ByVal e As EventArgs)
	' Number of copies to print
	Dim copies As Object = "1"

	' Page range to print, e.g., pages 1 to 3
	Dim pages As Object = "1-3"

	' Print the document with specified copies and page range
	wordDoc.PrintOut(Copies:= copies, Pages:= pages)
End Sub
$vbLabelText   $csharpLabel

En el código fuente anterior, especificamos el rango de páginas y el número de copias, pero las personalizaciones potenciales son vastas.

Personalización de la configuración de impresión

La capacidad para modificar la configuración de impresión es lo que distingue el control programático. Ya sea que desees ajustar la configuración de la impresora, definir una impresora específica o incluso imprimir el documento silenciosamente, todo está al alcance de la mano con Interop.

Impresión silenciosa

La impresión silenciosa se trata de enviar el documento a la impresora sin ninguna interacción del usuario:

// Object to determine whether to print in the background or not
object background = false;

// Print the document silently (no user interactions)
wordDoc.PrintOut(Background: ref background);
// Object to determine whether to print in the background or not
object background = false;

// Print the document silently (no user interactions)
wordDoc.PrintOut(Background: ref background);
' Object to determine whether to print in the background or not
Dim background As Object = False

' Print the document silently (no user interactions)
wordDoc.PrintOut(Background:= background)
$vbLabelText   $csharpLabel

Especificación de una impresora

Para imprimir un documento en una impresora específica que no sea la predeterminada:

// Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name";

// Print the document using the specified printer
wordDoc.PrintOut();
// Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name";

// Print the document using the specified printer
wordDoc.PrintOut();
' Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name"

' Print the document using the specified printer
wordDoc.PrintOut()
$vbLabelText   $csharpLabel

Configuración avanzada de la impresora

Más allá de solo especificar la impresora, uno podría necesitar ajustar las configuraciones de la impresora:

// Creates a PrintDialog to allow the user to choose printer settings
PrintDialog printDialog = new PrintDialog();
if (printDialog.ShowDialog() == DialogResult.OK)
{
    // Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName;

    // Prints the document using user's selected printer settings
    wordDoc.PrintOut();
}
// Creates a PrintDialog to allow the user to choose printer settings
PrintDialog printDialog = new PrintDialog();
if (printDialog.ShowDialog() == DialogResult.OK)
{
    // Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName;

    // Prints the document using user's selected printer settings
    wordDoc.PrintOut();
}
' Creates a PrintDialog to allow the user to choose printer settings
Dim printDialog As New PrintDialog()
If printDialog.ShowDialog() = DialogResult.OK Then
	' Sets the Word application's active printer to the user's choice
	wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName

	' Prints the document using user's selected printer settings
	wordDoc.PrintOut()
End If
$vbLabelText   $csharpLabel

De esta manera, el usuario puede ajustar manualmente configuraciones como orientación, impresión dúplex, y más.

Presentamos IronWord

Mientras que Microsoft Interop proporciona funcionalidades para manejar documentos de Word, no es tan robusto y eficiente como debería ser para un uso comercial serio. Entra IronWord: una alternativa superior a Interop para el procesamiento de archivos DOCX de Word. IronWord permite la lectura, escritura y manipulación sin problemas de archivos de Excel en C#. Aprende más sobre cómo comenzar con IronWord.

IronXL para .NET: La Biblioteca C# Excel

Conclusión

En este tutorial, hemos profundizado en los pasos involucrados en aprovechar Microsoft Interop para imprimir documentos de Word programáticamente en una aplicación de consola C#. Hemos visto cómo mostrar el cuadro de diálogo de impresión, establecer configuraciones de impresión personalizadas, y controlar varios aspectos de impresión como elegir una impresora específica o definir un rango de páginas. Si bien Interop ofrece capacidades fundamentales, vale la pena señalar que hay potentes alternativas como IronWord.

Preguntas Frecuentes

¿Cuáles son los requisitos previos para imprimir documentos de Word en C#?

Para imprimir documentos de Word en C#, necesita tener Microsoft Word y Visual Studio instalados en su máquina. Alternativamente, puede usar IronWord para el procesamiento de documentos, que no requiere que Microsoft Word esté instalado.

¿Cómo puedo crear una nueva aplicación de consola en Visual Studio para la impresión de documentos de Word?

Para crear una nueva aplicación de consola en Visual Studio, abra el IDE, seleccione 'Crear un nuevo proyecto', busque 'Aplicación de consola', elija la plantilla de C# y nombre su proyecto en consecuencia.

¿Cómo agrego una referencia a la biblioteca Microsoft Interop para la impresión de documentos de Word?

En Visual Studio, haga clic derecho en su proyecto, seleccione Agregar > Referencia, y en la pestaña COM, seleccione 'Microsoft Word xx.x Object Library'. Con IronWord, puede gestionar documentos de Word sin necesitar referencias COM.

¿Cuál es el papel del objeto de documento en los servicios Interop de Word?

El objeto de documento en los servicios Interop representa un documento de Microsoft Word y permite la manipulación programática del documento. IronWord ofrece capacidades similares con un rendimiento y eficiencia mejorados.

¿Cómo imprimir un documento de Word con configuraciones predeterminadas en C#?

Puede imprimir un documento de Word con configuraciones predeterminadas del impresor utilizando el método wordDoc.PrintOut() en Interop. IronWord ofrece un proceso de impresión simplificado con más control sobre las configuraciones.

¿Qué pasos están involucrados en la personalización de configuraciones de impresión para documentos de Word en C#?

Para personalizar configuraciones de impresión, como el número de copias o el rango de páginas, use el método PrintOut con parámetros especificados como Copies: ref copies y Pages: ref pages. IronWord ofrece opciones similares para impresión personalizable.

¿Cómo funciona la impresión en silencio para documentos de Word en C#?

La impresión en silencio permite imprimir documentos sin interacción del usuario configurando el parámetro Background como falso en el método wordDoc.PrintOut(Background: ref background). IronWord admite la impresión en silencio de manera eficiente.

¿Cómo puedo seleccionar una impresora que no sea la predeterminada para imprimir documentos de Word en C#?

Puede especificar una impresora diferente configurando wordApp.ActivePrinter al nombre de la impresora deseada antes de ejecutar wordDoc.PrintOut(). IronWord habilita una funcionalidad similar para la selección de impresora.

¿Cuáles son los beneficios de usar IronWord para procesar documentos de Word en C#?

IronWord ofrece un procesamiento robusto y eficiente de documentos de Word, permitiendo una lectura, escritura y manipulación sin problemas de archivos DOCX en C# sin necesidad de instalar Microsoft Word.

¿Cómo puedo introducir un cuadro de diálogo de impresión para la personalización al imprimir documentos de Word en C#?

Para introducir un cuadro de diálogo de impresión, use la clase PrintDialog para que los usuarios elijan configuraciones de la impresora, luego configure wordApp.ActivePrinter con el nombre de la impresora seleccionada antes de imprimir. IronWord también admite cuadros de diálogo de impresión personalizados por el usuario.

Jordi Bardia
Jordi Bardia
  Chatea con el equipo de ingeniería ahora
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Comenzar prueba gratuita