Cómo agregar una imagen a un archivo DOCX en C

This article was translated from English: Does it need improvement?
Translated
View the article in English

Las imágenes pueden usarse para agregar contexto visual a un documento de Word existente. Para describir una oración, un párrafo o simplemente un bloque de texto sin formato. Agregar imágenes a un documento de Word (.docx) es sencillo con IronWord (biblioteca AC# para trabajar con archivos DOCX). Esta guía cubrirá los pasos necesarios para agregar imágenes a un archivo .docx dentro de un entorno .NET.

Prueba IronWord

Comience a usar IronWord en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer


Agregar una imagen

Una imagen se referencia programáticamente usando su ruta definida en el sistema local. Primero, instanciar la clase ImageContent proporcionando la ruta del archivo en cadena. Luego, la variable image puede usarse en todo el archivo en varias ubicaciones o solo para modificar sus propiedades, por ejemplo, ancho, altura. Finalmente, agregar la imagen al archivo .docx usando la función AddImage(). Una vez agregada, el documento puede exportarse y guardarse localmente. En el ejemplo a continuación, estamos agregando la imagen dentro del documento sin ningún nodo padre. Los formatos de archivo compatibles son: .jpg, .png, .bmp, .tiff, .gif.

ConsejosSe puede insertar una imagen como elemento secundario dentro de un párrafo para mejorar la jerarquía del documento. El párrafo también puede definir el ajuste de texto y otras propiedades de formato de texto.

: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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
Añadir imagen

Agregar imagen a través de Stream

Para agregar imágenes que están detrás de una API segura, requiriendo autenticación, el método Stream sería apropiado. Para agregar imágenes que están detrás de una API segura, que requiere autenticación, el método Stream sería apropiado. Modificar propiedades de imagen

: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;

// 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 = client.GetStreamAsync("https://api.example.com/secure/image.png");
    doc.AddImage(authenticatedStream);
}

// Export docx
doc.SaveAs("added-image-via-http-stream.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Modificar las propiedades de la imagen

IronWord proporciona métodos de personalización predeterminados para una imagen.

Configuraciones Descripción Ejemplo
Width Dimensión horizontal de la imagen en píxeles image.Width = 500;
Height Dimensión vertical de la imagen en píxeles image.Height = 300;
WrapText Comportamiento de ajuste de texto alrededor de la imagen image.WrapText = WrapText.Square;
DistanciaDeLaIzquierda Medida de espaciado desde el borde izquierdo en píxeles image.DistanceFromLeft = 10;
DistanciaDeLaDerecha Medida de espaciado desde el borde derecho en píxeles image.DistanceFromRight = 10;
DistanciaDesdeTop Medida de espaciado desde el borde superior en píxeles image.DistanceFromTop = 15;
DistanciaDesdeAbajo Medida de espaciado desde el borde inferior en píxeles image.DistanceFromBottom = 15;
Position Información de ubicación espacial (coordenadas X e Y) image.Position = new ElementPosition(50, 100);
Scale Factores de dimensionamiento proporcional para los ejes X e Y image.Scale = new PointF(1.5f, 1.5f);
Translate Coordenadas de desplazamiento para reposicionamiento image.Translate = new PointF(20, 30);

Personalización de ancho y alto

Se muestra un ejemplo a continuación.

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.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.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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
Agregar imagen de tamaño personalizado

Preguntas Frecuentes

¿Cómo puedo añadir una imagen a un archivo DOCX usando C#?

Puedes añadir una imagen a un archivo DOCX programáticamente en C# utilizando IronWord. Te permite manipular documentos de Word fácilmente, incluyendo la inserción de imágenes.

¿Qué tipos de imágenes pueden añadirse a un DOCX usando IronWord?

IronWord soporta varios formatos de imagen, incluyendo JPEG, PNG, BMP y GIF, que pueden añadirse a un archivo DOCX.

¿Es posible posicionar imágenes dentro de un documento de Word usando IronWord?

Sí, IronWord permite un control preciso sobre el posicionamiento de imágenes dentro de un documento de Word, permitiéndote especificar localidades y alineación.

¿Puedo añadir múltiples imágenes a un solo documento de Word con IronWord?

Absolutamente. IronWord soporta la adición de múltiples imágenes a un solo documento de Word, permitiendo diseños de documentos complejos.

¿IronWord soporta la adición de imágenes en encabezados y pies de página?

Sí, IronWord puede ser usado para añadir imágenes tanto en encabezados como en pies de página dentro de un documento de Word, mejorando el diseño de tu documento.

¿Cómo maneja IronWord el escalado y la redimensión de imágenes?

IronWord proporciona funcionalidades para escalar y redimensionar imágenes a medida que son añadidas a un documento de Word, asegurando que encajen perfectamente en el diseño.

¿Puedo añadir leyendas a las imágenes en un archivo DOCX usando IronWord?

Sí, IronWord te permite añadir leyendas a las imágenes, mejorando la claridad y el contexto dentro de tus documentos de Word.

¿Es posible reemplazar una imagen existente en un documento de Word usando IronWord?

IronWord te permite reemplazar imágenes existentes en un documento de Word, ofreciendo flexibilidad en las actualizaciones y ediciones del documento.

¿Cuáles son los requisitos del sistema para usar IronWord para añadir imágenes a archivos DOCX?

IronWord requiere soporte de .NET framework y es compatible con entornos Windows, macOS y Linux para añadir imágenes a archivos DOCX.

¿Puedo automatizar el proceso de añadir imágenes a archivos DOCX usando IronWord?

Sí, IronWord facilita la automatización del proceso de adición de imágenes en archivos DOCX, agilizando la creación y edición de documentos.

Ahmad Sohail
Desarrollador Full Stack

Ahmad es un desarrollador full-stack con una sólida base en C#, Python y tecnologías web. Tiene un profundo interés en construir soluciones de software escalables y disfruta explorando cómo el diseño y la funcionalidad se encuentran en aplicaciones del mundo real.

Antes ...

Leer más
¿Listo para empezar?
Nuget Descargas 27,129 | Version: 2025.11 recién lanzado