Hinzufügen von Bildern zu DOCX in C

Bild hinzufügen

Ein Bild wird programmatisch unter Verwendung seines definierten Pfades im lokalen System aufgerufen. Zuerst instanziieren Sie 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 ohne übergeordnetes Element 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, lassen sich mit der vorherigen Methode ziemlich einfach in eine .docx-Datei einfügen. Um Bilder hinzuzufügen, die hinter einer sicheren API liegen und Authentifizierung erfordern, wäre die Stream-Methode geeignet. Im folgenden Beispiel sendet ein HTTP-Client Autorisierungstoken an den Server, ruft den authentifizierten Bildstream nach der Überprüfung ab und integriert ihn direkt vor dem Export der endgültigen .docx-Datei.

: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

Bildattribute ändern

IronWord bietet standardmäßige Anpassungsmethoden für ein Bild.

Breite & Höhe anpassen

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

: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