Cómo Añadir Imagen a DOCX en C

Prueba IronWord

¿Cómo añado una imagen a un DOCX?

Haga referencia a una imagen utilizando su ruta de archivo. Primero, instancie la clase ImageContent con la ruta del archivo como una cadena. Utilice la variable image a lo largo del archivo para modificar propiedades como ancho y altura. Añada la imagen al archivo .docx utilizando la función AddImage(). Exporte y guarde el documento localmente.

El ejemplo siguiente añade una imagen al documento sin ningún nodo padre. Los formatos de archivo admitidos son .jpg, .png, .bmp, .tiff y .gif. Esta flexibilidad permite trabajar con cualquier formato de imagen común.

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.jpg");

// modifying image properties
image.Width = 200;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("inserted-image.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Initializing docx file
Dim doc As New IronWord.WordDocument()

' Instantiating image file
Dim image As New IronWord.Models.ImageContent("sample-image.jpg")

' Modifying image properties
image.Width = 200
image.Height = 200

' AddImage function saving the image
doc.AddImage(image)

' Save and export the file
doc.SaveAs("inserted-image.docx")

Inserción de imágenes en documentos con requisitos regulatorios españoles

En el contexto empresarial español, los documentos DOCX con imágenes incorporadas pueden estar sujetos a normativa sectorial específica. La automatización de la inserción de imágenes con IronWord resulta especialmente relevante en los siguientes escenarios:

Facturas electrónicas con logotipos corporativos: Las empresas obligadas a emitir facturas en formato Facturae — el estándar XML definido por la AEAT para la facturación electrónica — habitualmente generan también una versión DOCX o PDF del documento para entregar al cliente. Cuando el documento Word incluye el logotipo corporativo, los sellos de calidad o la imagen de firma del responsable, la clase ImageContent de IronWord permite automatizar esta inserción de forma programática, sin depender de plantillas manuales. Para documentos que deban enviarse a través de la plataforma FACe (Punto General de Entrada de Facturas de las Administraciones Públicas), la versión DOCX con imágenes sirve de respaldo auditable del documento XML transmitido.

Documentos de consentimiento LOPDGDD con imagen de firma: Cuando una empresa española recoge el consentimiento informado de un interesado conforme a la LOPDGDD y desea archivar ese consentimiento en formato Word, puede ser necesario insertar la imagen de la firma manuscrita digitalizada del interesado. La AEPD recomienda que estos documentos sean conservados con garantías de integridad; el uso de ImageContent con parámetros de tamaño estandarizados garantiza que todas las imágenes de firma ocupen el mismo espacio en el documento, facilitando la revisión por parte de inspectores de la AEPD o auditores de cumplimiento.

Documentos técnicos bajo el ENS: Las organizaciones que operan sistemas de información bajo el ENS (Esquema Nacional de Seguridad) frecuentemente necesitan generar documentación técnica con capturas de pantalla, diagramas de arquitectura o evidencias de configuración. La inserción programática de estas imágenes mediante IronWord en documentos DOCX permite automatizar la generación de informes de seguridad, reduciendo el error humano y asegurando la trazabilidad documental exigida por el BOE para los procesos de certificación ENS.

¿Cómo añado imágenes a través de Stream?

Las imágenes de URL locales o estáticas son fáciles de añadir con el método anterior. Sin embargo, las aplicaciones suelen trabajar con imágenes de bases de datos, servicios web o contenidos generados dinámicamente. Utilice el método Stream para añadir imágenes detrás de APIs seguras que requieren autenticación.

El siguiente ejemplo muestra un cliente HTTP que envía tokens de autorización para recuperar un flujo de imágenes autenticado. La secuencia se integra directamente en el documento antes de exportarlo. Este enfoque elimina el almacenamiento temporal de archivos y mejora la seguridad de los datos sensibles de las imágenes.

:path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

using (HttpClient client = new HttpClient())
{
    // Add authentication headers
    client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY_HERE");
    client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0");

    // Get image from authenticated endpoint
    Stream authenticatedStream = await client.GetStreamAsync("https://api.example.com/secure/image.png");
    doc.AddImage(authenticatedStream);
}

// Export docx
doc.SaveAs("added-image-via-http-stream.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

' initializing docx file
Dim doc As New IronWord.WordDocument()

Using client As New HttpClient()
    ' Add authentication headers
    client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY_HERE")
    client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0")

    ' Get image from authenticated endpoint
    Dim authenticatedStream As Stream = Await client.GetStreamAsync("https://api.example.com/secure/image.png")
    doc.AddImage(authenticatedStream)
End Using

' Export docx
doc.SaveAs("added-image-via-http-stream.docx")

¿Cómo puedo modificar las propiedades de una imagen?

IronWord ofrece métodos completos para personalizar las propiedades de las imágenes. Ajuste estas propiedades antes o después de añadir la imagen al documento.

¿Cómo puedo personalizar la anchura y la altura?

Implementar anchura y altura personalizadas alterando la relación de aspecto. Controlar cómo aparecen las imágenes en los documentos, ya sea manteniendo las proporciones o ajustándose a restricciones de maquetación específicas.

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs

using IronWord;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.tiff");

// modifying the aspect ratio by introducing custom width
image.Width = 800;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("custom-size-image.docx");

Imports IronWord

' initializing docx file
Dim doc As New IronWord.WordDocument()

' instantiating image file
Dim image As New IronWord.Models.ImageContent("sample-image.tiff")

' modifying the aspect ratio by introducing custom width
image.Width = 800
image.Height = 200

' AddImage function saving the image
doc.AddImage(image)

' Save and export the file
doc.SaveAs("custom-size-image.docx")

$vbLabelText   $csharpLabel