Nasıl C# ile DOCX'e Görüntü Eklenir

Hangi Görüntü Formatları Desteklenir?

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

Görüntü Belgede Nereye Yerleştirilir?

Görüntüler varsayılan olarak, herhangi bir üst düğüm olmadan mevcut imleç konumuna eklenir. Keskin pozisyonlama için, görüntüleri paragraflar içinde bir çocuk öğe olarak ekleyin. Bu, metin akışı üzerinde daha fazla kontrol sağlar ve görüntüleri belgenizin yapısı ile bütünleştirir.

ImageContent Sınıfı Neden Kullanılmalı?

ImageContent sınıfı, görüntü özelliklerini yapılandırılmış bir şekilde yönetir. Boyutları, konumlandırmayı ve biçimlendirmeyi eklemeden önce değiştirebilirsiniz. Bu yaklaşım, belge oluşturma sürecinizde tutarlılık garanti eder ve uygulamanız boyunca standart biçimlendirme kurallarının uygulanmasını sağlar. Sınıf, tüm görüntüyle ilgili özellikleri kapsar, bu da kodun daha bakımını kolaylaştırır ve biçimlendirme hatalarını azaltır.

Akış Yoluyla Görüntü Nasıl Eklerim?

Yerel veya statik URL görüntüleri, önceki yöntem kullanılarak kolayca eklenebilir. Ancak, uygulamalar genellikle veritabanlarından, web hizmetlerinden veya dinamik olarak üretilen içerikten gelen görüntülerle çalışır. Kimlik doğrulama gerektiren güvenli API'lerin arkasına resim eklemek için Stream yöntemini kullanın.

Aşağıdaki örnek, yetkilendirme belirteçlerini gönderen bir HTTP istemcisi üzerinden kimliği doğrulanmış görüntü akışını almayı gösterir. Akış, dışa aktarılmadan önce doğrudan belgeye entegre edilmiştir. Bu yaklaşım, geçici dosya depolamayı ortadan kaldırır ve hassas görüntü 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")

Ne Zaman Stream Yöntemi Kullanmalıyım?

Aşağıdaki durumlarda Stream yöntemini kullanın:

• Görüntüler kimlik doğrulama gerektiren güvenli API'ler arkasında olduğunda
• Bellekten dinamik olarak görüntü işlemek için
• Verilerin veri tabanlarında ikili veri olarak saklandığı görüntülerle çalışmak

Bu yöntem, resimlerin belge yönetim sistemlerinde, bulut depolama biriminde saklandığı veya görüntü işleme servisleri tarafından oluşturulduğu kurumsal uygulamalarda iyi çalışır.

Stream Yüklemenin Avantajları Nelerdir?

Stream yükleme, geçici dosyalar kaydetmeden doğrulanmış uç noktalarından görüntüleri entegre eder. Bu, güvenliği ve performansı artırır. Avantajlar şunları içerir:

• Azaltılmış disk G/Ç işlemleri
• Diskte hassas görüntü önbelleği yok
• Gerçek zamanlı görüntü işleme iş akışları
• Büyük görüntüler için daha iyi bellek yönetimi
• Esnek görüntü kaynağı seçenekleri

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

Özelleştirilmiş bir genişlik ve yükseklik uygulamak için en-boy oranını değiştirin. Belirli düzen sınırlamalarına uygun olarak veya oranları koruyarak belgelerdeki görüntülerin nasıl görüneceğini 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")

En-Boy Oranına Ne Olur?

Özelleştirilmiş genişlik ve yükseklik değerleri orijinal en-boy oranını geçersiz kılar. Başlıklar, yan çubuklar veya sabit boyutlu kaplar gibi düzen gereksinimlerine uymak için görüntüleri gerin veya sıkıştırın. Aşırı çarpıklık profesyonel görünmeyebilir. Boyutlandırırken en-boy oranını korumak için hedef boyutunuza dayalı orantılı boyutları hesaplayın.

Önce Hangi Özellikleri Ayarlamalıyım?

Özellikleri bu sırayla ayarlayın:

1. Boyutlar (genişlik/yükseklik) - görüntü düzeninin temeli
2. Konumlandırma (DistanceFrom özellikleri) - boşluk ve marjları kontrol etme
3. İleri düzey özellikler (ölçek/çevir) - ayrıntılı ayar

Bu yaklaşım, her bir özelliğin mantıklı bir şekilde öncekilerin üzerine inşa edilmesini sağlar. Bazı özellikler etkileşimlidir - metin sarma, mesafe özelliklerinin çalışma biçimini etkiler.