How to Add Image to DOCX

Bild hinzufügen

Ein Bild wird programmatisch unter Verwendung seines definierten Pfades im lokalen System aufgerufen. Instanziieren Sie zuerst die ImageContent-Klasse, indem Sie den Dateipfad als String angeben. Dann kann die image-Variable im gesamten Dokument in verschiedenen Positionen oder nur zur Änderung ihrer Eigenschaften wie Breite und Höhe verwendet werden. Schließlich fügen Sie das Bild mit der AddImage()-Funktion in die .docx-Datei ein. Einmal hinzugefügt, kann das Dokument lokal exportiert und gespeichert werden. Im folgenden Beispiel fügen wir das Bild direkt ohne übergeordnete Knoten in das Dokument ein. Die unterstützten Dateiformate sind: .jpg, .png, .bmp, .tiff, .gif.

: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

Bild über Stream hinzufügen

Bilder, die lokal oder über eine statische URL bereitgestellt werden, können direkt in eine .docx-Datei mit der vorherigen Methode hinzugefügt werden.

Um Bilder hinzuzufügen, die hinter einer sicheren API liegen und Authentifizierung erfordern, wäre die Stream-Methode geeignet. Im untenstehenden Beispiel sendet ein HTTP-Client Autorisierungstokens an den Server, ruft den authentifizierten Bildstream nach der Verifizierung ab und integriert ihn direkt, bevor die endgültige .docx-Datei exportiert wird. ## Bild-Eigenschaften ändern

: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

IronWord bietet Standard-Anpassungsmethoden für ein Bild.

Breite & Höhe anpassen

Benutzerdefinierte Breite und Höhe können durch Ändern des vordefinierten Seitenverhältnisses implementiert werden.

Ein Beispiel ist unten dargestellt.

: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