How to Add Image to DOCX

Añadir una imagen

Una imagen se referencia mediante programación utilizando su ruta definida en el sistema local. En primer lugar, instancie la clase ImageContent proporcionando la ruta del archivo en cadena. A continuación, la variable image puede utilizarse a lo largo de todo el archivo en varias ubicaciones o simplemente para modificar sus propiedades, por ejemplo, anchura, altura. Por último, añade la imagen al archivo .docx mediante la función AddImage(). Una vez añadido, el documento puede exportarse y guardarse localmente. En el ejemplo siguiente, estamos añadiendo la imagen dentro del documento sin ningún nodo padre. Los formatos de archivo admitidos son: .jpg, .png, .bmp, .tiff, .gif.

{t:(Se puede insertar una imagen como elemento hijo dentro de un párrafo para mejorar la jerarquía del documento. El párrafo también puede definir el ajuste del texto y otras propiedades de formato del 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

Añadir imagen a través de stream

Las imágenes que se sirven localmente o a través de una URL estática son bastante fáciles de añadir directamente a un archivo .docx utilizando el método anterior. Para añadir imágenes que están detrás de una API segura, que requiere autenticación, el método Stream sería apropiado. En el ejemplo siguiente, un cliente HTTP envía tokens de autorización al servidor, recupera el flujo de imágenes autenticado tras la verificación y lo integra directamente antes de exportar el archivo .docx final.

: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

Modificación de las propiedades de las imágenes

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

Personalización de la anchura y la altura

Se puede personalizar la anchura y la altura alterando la relación de aspecto predefinida. A continuación se muestra un ejemplo.

: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