1. IronWord
  2. Anleitungen
  3. Bild hinzufügen

Hinzufügen von Bildern zu DOCX in C

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

IronWord bietet die Klasse ImageContent zum Einfügen von Bildern (.jpg, .png, .bmp, .tiff, .gif) in DOCX-Dateien mit anpassbaren Eigenschaften wie Breite, Höhe und Textumbruch. Verwenden Sie IronWord, um Bilder zu Word-Dokumenten hinzuzufügen, um Dokumente zu automatisieren und Berichte zu erstellen.

als-Überschrift:2(Schnellstart: Bild zu DOCX in C# hinzufügen)

  1. IronWord über NuGet Package Manager installieren
  2. Erstellen Sie eine neue WordDocument-Instanz
  3. Laden Sie Ihr Bild mit der ImageContent Klasse
  4. Fügen Sie das Bild mit AddImage() in das Dokument ein
  5. Speichern Sie das Dokument als DOCX

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronWord mit dem NuGet-Paketmanager.

    PM > Install-Package IronWord

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    using IronWord;
using IronWord.Models;

// Create new document
WordDocument doc = new WordDocument();

// Add image
ImageContent image = new ImageContent("photo.jpg");
doc.AddImage(image);

// Save document
doc.SaveAs("document-with-image.docx");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronWord in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Testen Sie IronWord

Nutzen Sie IronWord heute kostenlos in Ihrem Projekt.

Erster Schritt:
green arrow pointer

Hinzufügen eines Bildes zu DOCX

  1. Laden Sie die neueste stabile Version von IronWord herunter
  2. Initialisieren Sie ein neues Word-Dokument
  3. Definieren Sie ein Bildobjekt (.bmp, .jpg, .png, oder andere unterstützte Formate)
  4. Fügen Sie das Bild zum Dokument hinzu
  5. Speichern und exportieren Sie die Dokumentdatei

Wie kann ich ein Bild in DOCX einfügen?

Verweisen Sie auf ein Bild über seinen Dateipfad. Zunächst instanziieren Sie die Klasse ImageContent mit dem Dateipfad als String. Verwenden Sie die Variable image in der gesamten Datei, um Eigenschaften wie Breite und Höhe zu ändern. Fügen Sie das Bild mit der Funktion AddImage() in die .docx-Datei ein. Exportieren und speichern Sie das Dokument lokal.

Das folgende Beispiel fügt dem Dokument ein Bild ohne einen übergeordneten Knoten hinzu. Unterstützte Dateiformate sind .jpg, .png, .bmp, .tiff und .gif. Dank dieser Flexibilität können Sie mit jedem gängigen Bildformat arbeiten.

TippsEin Bild als untergeordnetes Element in einen Absatz einfügen, um die Dokumenthierarchie zu verbessern. Der Absatz definiert den Textumbruch und andere Textformatierungseigenschaften. Dieser Ansatz bietet mehr Kontrolle über die Stelleierung der Bilder und ermöglicht es, dass die Bilder mit dem umgebenden Text fließen.

: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
Word-Dokument mit eingefügtem Bild der nächtlichen Stadtsilhouette und Registerkarte Home mit Formatierungsoptionen

Welche Bildformate werden unterstützt?

Unterstützte Dateiformate: .jpg, .png, .bmp, .tiff, und .gif. Jedes Format behält beim Einfügen seine Qualität bei. JPEG eignet sich am besten für Fotos. PNG unterstützt Transparenz für Logos und Grafiken. BMP liefert unkomprimierte Qualität. TIFF eignet sich für hochwertige Druckdokumente. GIF ermöglicht einfache Animationen (in statischen Dokumenten wird nur das erste Bild angezeigt).

Wo wird das Bild im Dokument platziert?

Bilder werden standardmäßig an der aktuellen Cursorposition eingefügt, ohne übergeordneten Knoten. Für eine präzise Stelleierung sollten Sie Bilder als untergeordnete Elemente in Absätze einfügen. Dies ermöglicht eine bessere Kontrolle über den Textfluss und integriert die Bilder in die Struktur Ihres Dokuments.

Warum die ImageContent-Klasse verwenden?

Die Klasse ImageContent verwaltet Bildeigenschaften auf strukturierte Weise. Ändern Sie Abmessungen, Stelleierung und Formatierung vor dem Einfügen. Dieser Ansatz gewährleistet Konsistenz im gesamten Prozess der Dokumentenerstellung und wendet Standardformatierungsregeln in Ihrer gesamten Anwendung an. Die Klasse kapselt alle bildbezogenen Eigenschaften, wodurch der Code leichter zu pflegen ist und Formatierungsfehler reduziert werden.

Wie füge ich Bilder per Stream hinzu?

Lokale oder statische URL-Bilder lassen sich mit der oben beschriebenen Methode leicht hinzufügen. Die Anwendungen arbeiten jedoch häufig mit Bildern aus Datenbanken, Webdiensten oder dynamisch generierten Inhalten. Verwenden Sie die Methode Stream, um Bilder hinter sicheren APIs hinzuzufügen, die eine Authentifizierung erfordern.

Das folgende Beispiel zeigt einen HTTP-Client, der Autorisierungstoken sendet, um einen authentifizierten Bildstrom abzurufen. Der Stream wird vor dem Export direkt in das Dokument integriert. Durch diesen Ansatz wird die Speicherung temporärer Dateien vermieden und die Sicherheit sensibler Bilddaten verbessert.

: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

Wann sollte ich die Stream-Methode verwenden?

Verwenden Sie die Methode Stream, wenn:

  • Die Bilder befinden sich hinter sicheren APIs, die eine Authentifizierung erfordern
  • Dynamische Verarbeitung von Bildern aus dem Speicher
  • Arbeiten mit Bildern, die als Binärdaten in Datenbanken gespeichert sind

Diese Methode eignet sich gut für Unternehmensanwendungen, bei denen Bilder in Dokumentenmanagementsystemen oder in der Cloud gespeichert oder von Bildverarbeitungsdiensten generiert werden.

Was sind die Vorteile von Stream Loading?

Stream Loading integriert Bilder von authentifizierten Endpunkten, ohne temporäre Dateien zu speichern. Dadurch werden Sicherheit und Leistung verbessert. Vorteile umfassen:

  • Reduzierte Festplatten-E/A-Vorgänge
  • Keine sensible Bildzwischenspeicherung auf der Festplatte
  • Bildverarbeitungs-Workflows in Echtzeit
  • Bessere Speicherverwaltung für große Bilder
  • Flexible Bildquellenoptionen

Wie kann ich die Bildeigenschaften ändern?

IronWord bietet umfassende Methoden zur Anpassung der Bildeigenschaften. Passen Sie diese Eigenschaften an, bevor oder nachdem Sie das Bild zum Dokument hinzufügen.

Einstellungen Beschreibung Beispiel
Breite Horizontale Abmessung des Bildes in Pixeln Bild.Breite = 500;
Höhe Vertikale Dimension des Bildes in Pixeln Bild.Höhe = 300;
WrapText Textumbruchverhalten um das Bild image.WrapText = WrapText.Square;
AbstandVonLinks Abstandsmaß vom linken Rand in Pixeln image.AbstandVonLinks = 10;
DistanceFromRight Abstandsmaß vom rechten Rand in Pixel image.DistanceFromRight = 10;
EntfernungVonOben Abstandsmaß vom oberen Rand in Pixeln image.EntfernungVonOben = 15;
AbstandVonBoden Abstandsmaß vom unteren Rand in Pixel image.AbstandVonBoden = 15;
Stelle Räumliche Platzierungsinformationen (X- und Y-Koordinaten) Bild.Stelle = new ElementStelle(50, 100);
Maßstab Proportionale Größenfaktoren für X- und Y-Achsen image.Maßstab = new PointF(1.5f, 1.5f);
Übersetzen Sie Verschiebungskoordinaten für die Neupositionierung image.Übersetzen Sie = new PointF(20, 30);

Wie kann ich Breite und Höhe anpassen?

Implementieren Sie benutzerdefinierte Breite und Höhe durch Ändern des Seitenverhältnisses. Kontrollieren Sie, wie die Bilder in den Dokumenten erscheinen, ob sie die Proportionen einhalten oder in bestimmte Layoutvorgaben passen.

: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
Word-Dokument mit Laptop-Bild und 'Tagged Image File F'-Überlagerungstext zur Veranschaulichung der Bildeigenschaften

Was passiert mit dem Seitenverhältnis?

Benutzerdefinierte Werte für Breite und Höhe setzen das ursprüngliche Seitenverhältnis außer Kraft. Bilder strecken oder komprimieren, um sie an Layout-Anforderungen wie Kopfzeilen, Seitenleisten oder Container mit fester Größe anzupassen. Extreme Verzerrungen können unprofessionell wirken. Um das Seitenverhältnis bei der Größenänderung beizubehalten, berechnen Sie die proportionalen Abmessungen auf der Grundlage Ihrer Zielgröße.

Welche Eigenschaften sollte ich zuerst einstellen?

Legen Sie die Eigenschaften in dieser Reihenfolge fest:

  1. Abmessungen (Breite/Höhe) - Grundlage für das Bildlayout
  2. Stelleierung (DistanceFrom-Eigenschaften) - Steuerung von Abständen und Rändern
  3. Erweiterte Eigenschaften (Skalieren/Übersetzen) - Feinabstimmung

Dieser Ansatz stellt sicher, dass jede Eigenschaft logisch auf der vorherigen aufbaut. Einige Eigenschaften interagieren - der Textumbruch beeinflusst die Funktionsweise von Abstandseigenschaften.

Häufig gestellte Fragen

Wie füge ich in C# ein Bild zu einer DOCX-Datei hinzu?

Mit IronWord können Sie Bilder zu DOCX-Dateien hinzufügen, indem Sie eine ImageContent-Instanz mit dem Pfad Ihrer Bilddatei erstellen und dann die Methode AddImage() verwenden. IronWord unterstützt gängige Formate wie JPG, PNG, BMP, TIFF und GIF, so dass es einfach ist, Bilder programmatisch in Word-Dokumente einzufügen.

Welche Bildformate werden beim Einfügen von Bildern in Word-Dokumente unterstützt?

IronWord unterstützt alle gängigen Bildformate, einschließlich .jpg, .png, .bmp, .tiff und .gif-Dateien. Jedes Format behält seine Qualität bei, wenn es eingefügt wird - JPEG für Fotos, PNG für Grafiken mit Transparenz, BMP für unkomprimierte Qualität, TIFF für hochwertige Druckdokumente und GIF für einfache Animationen (wobei nur das erste Bild angezeigt wird).

Kann ich die Größe und Positionierung von Bildern in DOCX-Dateien steuern?

Ja, mit der ImageContent-Klasse von IronWord können Sie Bildeigenschaften wie Breite, Höhe und Textumbruch anpassen. Sie können die Abmessungen und die Positionierung vor dem Einfügen ändern, so dass Sie die volle Kontrolle darüber haben, wie Bilder in Ihren Word-Dokumenten erscheinen.

Wie kann ich ein Bild in einen Absatz einfügen, um das Dokument besser zu strukturieren?

Mit IronWord können Sie Bilder als untergeordnete Elemente in Absätze einfügen und so eine bessere Dokumenthierarchie und Kontrolle über den Textumbruch erreichen. Dieser Ansatz integriert Bilder in den umgebenden Textfluss und bietet präzisere Positionierungsoptionen als das Hinzufügen von Bildern ohne übergeordneten Knoten.

Wie kann ich am schnellsten ein Bild programmgesteuert in ein Word-Dokument einfügen?

Die schnellste Methode mit IronWord besteht darin, eine WordDocument-Instanz zu erstellen, Ihr Bild mit new ImageContent('photo.jpg') zu laden, doc.AddImage(image) aufzurufen und mit doc.SaveAs('document-with-image.docx') zu speichern. Mit diesem einfachen vierstufigen Verfahren wird der gesamte Arbeitsablauf des Einfügens von Bildern abgewickelt.

Ahmad Sohail
Ahmad Sohail
  Jetzt mit dem Ingenieurteam chatten
Full-Stack-Entwickler

Ahmad ist ein Full-Stack-Entwickler mit einer soliden Grundlage in C#, Python und Webtechnologien. Er hat ein großes Interesse am Aufbau skalierbarer Softwarelösungen und genießt es, zu erkunden, wie Design und Funktionalität in realen Anwendungen aufeinandertreffen.

Bevor er dem Iron Software Team beitrat, arbeitete ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 28,054 | Version: 2025.12 gerade veröffentlicht