1. IronWord
  2. Nasıl Yapılır
  3. Görüntü Ekle

How to Add Image to DOCX in C

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

IronWord, les(.jpg, .png, .bmp, .tiff, .gif) dosyalarını DOCX dosyalarına yerleştirmek için özelleştirilebilir özelliklerle birlikte --ImageContent sınıfını sağlar. IronWord'u, belge otomasyonu ve rapor oluşturma icin Word belgelerine resim eklemek icin kullanin.

Hızlı Başlangıç: C#'ta DOCX'e Resim Ekle

  1. IronWord'u NuGet Paket Yöneticisi aracılığıyla yükleyin
  2. Yeni bir --WordDocument örneği oluşturun
  3. Görüntünüzü ImageContent sınıfını kullanarak yükleyin
  4. Görüntüyü AddImage() kullanarak belgeye ekleyin
  5. Belgeyi DOCX olarak kaydedin

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronWord yükleyin

    PM > Install-Package IronWord

  2. Bu kod parçasını kopyalayıp çalıştırın.

    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. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronWord kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

IronWord'u deneyin

DOCX belgesine resim nasıl eklenir

  1. IronWord'un en son kararlı sürümünü indirin
  2. Yeni bir Word belgesi başlatın
  3. Bir resim nesnesi tanımlayın (.bmp, .jpg, .png veya diğer desteklenen formatlar)
  4. Belgeye resmi ekleyin
  5. Belge dosyasını kaydedin ve dışa aktarın

DOCX belgesine nasıl resim eklerim?

Bir resme dosya yolu kullanarak referans verin. İlk olarak, dosya yolunu bir dizi olarak alan ImageContent sınıfını başlatın. Dosya boyunca genişlik ve yükseklik gibi özellikleri değiştirmek için image değişkenini kullanın. Görüntüyü .docx dosyasına eklemek için --AddImage() işlevini kullanın. Belgeyi yerel olarak dışa aktarın ve kaydedin.

Aşağıdaki örnek, belgeye herhangi bir üst düğüm olmadan bir resim ekler. Desteklenen dosya formatları arasında .jpg, .png, .bmp, .tiff ve .gif bulunmaktadır. Bu esneklik, herhangi bir yaygın resim formatıyla çalışmanıza olanak tanır.

İpuçlarıDaha iyi belge hiyerarşisi için bir paragraf içinde bir alt öğe olarak bir resim ekleyin. Paragraf, metin sarma ve diğer metin biçimlendirme özelliklerini tanımlar. Bu yaklaşım, resim konumlandırmasında daha fazla kontrol sağlar ve resimlerin çevreleyen metinle akmasını sağlar.

: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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Initializing docx file
Dim doc As New IronWord.WordDocument()

' Instantiating image file
Dim image As 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")
$vbLabelText   $csharpLabel
Word belgesinde gece vakti şehir siluetinin eklendiği ve Ev sekmesi şeridinde biçimlendirme seçeneklerini gösteren görüntü

Hangi Resim Formatları Desteklenir?

Desteklenen dosya formatları: .jpg, .png, .bmp, .tiff ve .gif. Her format eklendiğinde kalitesini korur. Fotoğraflar için JPEG en iyi çalışır. PNG, logolar ve grafikler için şeffaflık desteği sunar. BMP sıkıştırılmamış kalite sağlar. TIFF yüksek kaliteli baskı belgelerine uygundur. GIF basit animasyonlar sağlar (statik belgelerde sadece ilk kare görüntülenir).

Resim Belgeye Nerede Yerleştirilir?

Resimler varsayılan olarak geçerli imleç konumuna, herhangi bir üst düğüm olmaksızın eklenir. Kesin konumlandırma için resimleri paragraflar içinde çocuk öğe olarak ekleyin. Bu, metin akışını daha iyi kontrol eder ve resimleri belgenizin yapısıyla entegre eder.

Neden ImageContent Sınıfı Kullanılır?

ImageContent sınıfı, resim özelliklerini yapılandırılmış bir şekilde yönetir. Boyutları, konumlandırmayı ve biçimlendirmeyi eklemeden önce değiştirin. Bu yaklaşım, belge oluşturma sürecinizde tutarlılığı sağlar ve uygulamanın geneline standart biçimlendirme kurallarını uygular. Sınıf, kodu daha sürdürülebilir hale getirerek formatlama hatalarını azaltan tüm resimle ilgili özellikleri kapsar.

Ağı üzerinden resim nasıl eklerim?

Yerel veya statik URL'li resimler, önceki yöntem kullanılarak kolayca eklenir. Ancak, uygulamalar genellikle veri tabanlarından, web hizmetlerinden veya dinamik olarak oluşturulan içeriklerden resimlerle çalışır. Kimlik doğrulaması gerektiren güvenli API'lerin arkasında resimler eklemek için --Stream yöntemini kullanın.

Aşağıdaki örnek, yetkilendirme jetonlarını göndererek kimlik doğrulamalı bir resim akışı elde eden bir HTTP istemcisini gösterir. Akış, dışa aktarmadan önce doğrudan belgeye entegre edilir. Bu yaklaşım, geçici dosya depolamayı ortadan kaldırır ve hassas resim verileri için güvenliği artırır.

: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;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

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

// Export docx
doc.SaveAs("added-image-via-http-stream.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

' initializing docx file
Dim doc As New IronWord.WordDocument()

Using client As 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
    Dim authenticatedStream As Stream = Await client.GetStreamAsync("https://api.example.com/secure/image.png")
    doc.AddImage(authenticatedStream)
End Using

' Export docx
doc.SaveAs("added-image-via-http-stream.docx")
$vbLabelText   $csharpLabel

Stream Yöntemi Ne Zaman Kullanılmalıdır?

Şu durumlarda --Stream yöntemini kullanın:

  • Kimlik doğrulama gerektiren güvenli API'ların arkasındaki resimler
  • Dinamik olarak hafızadan işlenen resimler
  • Veri tabanlarında ikili veri olarak depolanan resimlerle çalışmak

Bu yöntem, belgelerin doküman yönetim sistemlerinde, bulut depolama alanlarında saklandığı veya görüntü işleme hizmetleri tarafından oluşturulduğu kurumsal uygulamalarda iyi çalışır.

Stream Yüklemenin Faydaları Nelerdir?

Stream yükleme, geçici dosyaları kaydetmeden yetkilendirilmiş uç noktalardan resimleri entegre eder. Bu güvenlik ve performansı artırır. Faydaları şunlardır:

  • Azaltılmış disk I/O işlemleri
  • Diskte hassas resim önbelleği olmaz
  • Gerçek zamanlı resim işleme iş akışları
  • Büyük resimler için daha iyi bellek yönetimi
  • Esnek resim kaynağı seçenekleri

Görsel Özellikleri Nasıl Değiştiririm?

IronWord, görüntü özelliklerini özelleştirmek için kapsamlı yöntemler sunar. Bu özellikleri, resmi belgeye eklemeden önce veya sonra ayarlayın.

Ayarlar Açıklama Örnek
Genişlik Pixellerdeki görüntünün yatay boyutu image.Genişlik = 500;
Yükseklik Pixellerdeki görüntünün dikey boyutu image.Yükseklik = 300;
Metin Sarma Görüntü etrafındaki metin sarma davranışı image.Metin Sarma = Metin Sarma.Square;
Soldan Uzaklık Sol kenardan olan mesafe ölçüsü pixel cinsinden image.Soldan Uzaklık = 10;
Sağdan Uzaklık Sağ kenardan olan mesafe ölçüsü pixel cinsinden image.Sağdan Uzaklık = 10;
Yukarıdan Uzaklık Üst kenardan olan mesafe ölçüsü pixel cinsinden image.Yukarıdan Uzaklık = 15;
Aşağıdan Uzaklık Alt kenardan olan mesafe ölçüsü pixel cinsinden image.Aşağıdan Uzaklık = 15;
Konum Mekansal yerleşim bilgisi (X ve Y koordinatları) image.Konum = new ElementKonum(50, 100);
Ölçek X ve Y eksenleri için orantılı boyutlandırma faktörleri image.Ölçek = new PointF(1.5f, 1.5f);
Çevir Yeniden konumlandırma için yer değiştirme koordinatları image.Çevir = new PointF(20, 30);

Genişlik ve Yüksekliği Nasıl Özelleştiririm?

Özel genişlik ve yükseklik, en-boy oranını değiştirerek uygulanır. Resimlerin belgelerde nasıl görüneceğini, orantıları koruyarak mı yoksa belirli yerleşim kısıtlamalarına mı uyacağını kontrol edin.

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs
using IronWord;

// 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");
Imports IronWord

' initializing docx file
Dim doc As New IronWord.WordDocument()

' instantiating image file
Dim image As 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")
$vbLabelText   $csharpLabel
Word belgesi, 'Tagged Image File F' kaplamalı metni ile dizüstü bilgisayar resmini göstererek, resim özelliği gösterimini sergiler

En-Boy Oranına Ne Olur?

Özel genişlik ve yükseklik değerleri, orijinal en-boy oranını geçersiz kılar. Başlıklar, yan paneller veya sabit boyutlu kaplar gibi yerleşim gereksinimlerine uyacak şekilde resimleri uzatın veya sıkıştırın. Aşırı bozulma profesyonel görünmeyebilir. Yeniden boyutlandırırken, hedef boyutunuza dayalı olarak orantılı boyutları hesaplayarak en-boy oranını koruyun.

Önce Hangi Özellikler Ayarlanmalıdır?

Özellikleri şu sırayla ayarlayın:

  1. Boyutlar (genişlik/yükseklik) - görüntü düzeninin temeli
  2. Konumlandırma (DistanceFrom özellikleri) - boşluklar ve marjlar üzerinde kontrol
  3. Gelişmiş özellikler (ölçek/çevirme) - ince ayar

Bu yaklaşım, her bir özelliğin mantıksal olarak önceki özelliklerin üzerine inşa edilmesini sağlar. Bazı özellikler etkileşimli - metin kaydırma, mesafe özelliklerinin nasıl çalıştığını etkiler.

Sıkça Sorulan Sorular

C# ile bir DOCX dosyasına nasıl resim eklerim?

IronWord ile, resim dosya yolunuzla bir ImageContent örneği oluşturarak ve ardından AddImage() yöntemini kullanarak DOCX dosyalarına resim ekleyebilirsiniz. IronWord, JPG, PNG, BMP, TIFF ve GIF gibi yaygın formatları destekleyerek, resimleri Word belgelerine programlı olarak eklemeyi kolay hale getiriyor.

Word belgelerine resim eklerken hangi resim formatları desteklenir?

IronWord, .jpg, .png, .bmp, .tiff ve .gif dosyaları dahil olmak üzere tüm ana resim formatlarını destekler. Her format, eklendiğinde kalitesini korur - fotoğraflar için JPEG, saydam grafikleri için PNG, sıkıştırılmamış kalite için BMP, yüksek kaliteli baskı belgeleri için TIFF ve basit animasyonlar için GIF (yalnızca ilk kare gösterilir).

DOCX dosyalarındaki resimlerin boyutunu ve konumunu kontrol edebilir miyim?

Evet, IronWord'un ImageContent sınıfı, genişlik, yükseklik ve metin sarma gibi resim özelliklerini özelleştirmenize olanak tanır. Boyutları ve konumlandırmayı eklemeden önce değiştirerek, resimlerin Word belgelerinizde nasıl göründüğü üzerinde tam kontrole sahip olursunuz.

Daha iyi belge yapısı için bir paragraf içine resim nasıl ekleyebilirim?

IronWord, paragraflar içinde çocuk öğeler olarak resimler eklemenize olanak tanır, bu da daha iyi belge hiyerarşisi sağlar ve metin sarmalamayı kontrol edebilir. Bu yaklaşım, resimleri çevresindeki metin akışı ile entegre eder ve ebeveyn düğümü olmadan resim eklemeye nazaran daha hassas konumlandırma seçenekleri sunar.

Bir Word belgesine programlı olarak bir resim eklemenin en hızlı yolu nedir?

IronWord ile en hızlı yöntem, bir WordDocument örneği oluşturarak başlamak, resminizi new ImageContent('photo.jpg') ile yüklemek, doc.AddImage(image) çağrısı yapmak ve doc.SaveAs('document-with-image.docx') ile kaydetmektir. Bu basit dört adımlı süreç, tüm resim ekleme iş akışını ele alır.

Ahmad Sohail
Ahmad Sohail
  Mühendislik takımıyla şimdi sohbet edin
Full Stack Geliştirici

Ahmad, C#, Python ve web teknolojilerinde güçlü bir temele sahip bir full-stack geliştiricidir. Ölçeklenebilir yazılım çözümleri oluşturma konusunda derin bir ilgiye sahiptir ve tasarım ile işlevselliğin gerçek dünya uygulamalarında nasıl birleştiğini keşfetmekten ...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 39,467 | Sürüm: 2026.4 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronWord
bir örnek çalıştır verilerinizin bir Word belgesine dönüştüğünü izleyin.