ImageFieldMergingArgs

ImageFieldMergingArgs class

Şunun için veri sağlar:ImageFieldMerging olay.

Daha fazlasını öğrenmek için şu adresi ziyaret edin:Adres Mektup Birleştirme ve Raporlama dokümantasyon makalesi.

public class ImageFieldMergingArgs : FieldMergingArgsBase

Özellikleri

İsimTanım
Document { get; }Şunu döndürür:Document Adres-mektup birleştirmenin gerçekleştirildiği nesne.
DocumentFieldName { get; }Belgede belirtildiği gibi birleştirme alanının adını alır.
Field { get; }Geçerli birleştirme alanını temsil eden nesneyi alır.
FieldName { get; }Veri kaynağındaki birleştirme alanının adını alır.
FieldValue { get; set; }Alanın değerini veri kaynağından alır veya ayarlar.
Image { get; set; }Adres-mektup birleştirme motorunun belgeye eklemesi gereken resmi belirtir.
ImageFileName { get; set; }Adres-mektup birleştirme motorunun belgeye eklemesi gereken resmin dosya adını ayarlar.
ImageHeight { get; set; }Belgeye eklenecek görüntünün görüntü yüksekliğini belirtir.
ImageStream { get; set; }Adres-mektup birleştirme motorunun bir görüntüyü okuyacağı akışı belirtir.
ImageWidth { get; set; }Belgeye eklenecek görüntünün görüntü genişliğini belirtir.
RecordIndex { get; }Birleştirilecek kaydın sıfır tabanlı dizinini alır.
Shape { get; set; }Adres-mektup birleştirme motorunun belgeye eklemesi gereken şekli belirtir.
TableName { get; }Geçerli birleştirme işlemi için veri tablosunun adını veya ad mevcut değilse boş dizeyi alır.

Notlar

Bu olay, adres-mektup birleştirme sırasında, belgede bir resim adres-mektup birleştirme alanıyla karşılaşıldığında meydana gelir. a dosya adını, akışını veya bir akışını döndürmek için bu etkinliğe yanıt verebilirsiniz.Image adres-mektup birleştirme motoruna itiraz ederek belgeye eklenmesini sağlayın.

Üç mülk mevcutImageFileName , ImageStream VeImage görüntünün nereden alınması gerektiğini belirtmek için. Bu özelliklerden yalnızca birini ayarlayın.

Word’deki bir belgeye resim adres-mektup birleştirme alanı eklemek için Ekle/Alan komutunu seçin, ardından MergeField’ı seçin ve Resim:AlanAdım yazın.

Örnekler

Veritabanı BLOB alanında saklanan görüntülerin bir rapora nasıl ekleneceğini gösterir.

public void ImageFromBlob()
{
    Document doc = new Document(MyDir + "Mail merge destination - Northwind employees.docx");

    doc.MailMerge.FieldMergingCallback = new HandleMergeImageFieldFromBlob();

    string connString = $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={DatabaseDir + "Northwind.accdb"};";
    string query = "SELECT FirstName, LastName, Title, Address, City, Region, Country, PhotoBLOB FROM Employees";

    using (OleDbConnection conn = new OleDbConnection(connString))
    {
        conn.Open();

        // Tüm kayıtları aynı anda okuyacak modda olması gereken veri okuyucuyu açın.
        OleDbCommand cmd = new OleDbCommand(query, conn);
        IDataReader dataReader = cmd.ExecuteReader();

        doc.MailMerge.ExecuteWithRegions(dataReader, "Employees");
    }

    doc.Save(ArtifactsDir + "MailMergeEvent.ImageFromBlob.docx");
}

private class HandleMergeImageFieldFromBlob : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        // Hiçbir şey yapma.
    }

    /// <summary>
    /// Adres-mektup birleştirme, belgede adında "Image:" etiketi bulunan bir MERGEFIELD ile karşılaştığında çağrılır.
    /// </summary>
    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs e)
    {
        MemoryStream imageStream = new MemoryStream((byte[])e.FieldValue);
        e.ImageStream = imageStream;
    }
}

Adres-mektup birleştirme sırasında MERGEFIELDS’in kabul ettiği görüntülerin boyutlarının nasıl ayarlanacağını gösterir.

public void MergeFieldImageDimension()
{
    Document doc = new Document();

    // Adres-mektup birleştirme sırasında bir kaynaktan gelen görüntüleri kabul edecek bir MERGEFIELD ekleyin. Referans vermek için alan kodunu kullanın
    // adres-mektup birleştirmede kullanmak istediğimiz görüntülerin yerel sistem dosya adlarını içeren veri kaynağındaki bir sütun.
    DocumentBuilder builder = new DocumentBuilder(doc);
    FieldMergeField field = (FieldMergeField)builder.InsertField("MERGEFIELD Image:ImageColumn");

    // Veri kaynağında "ImageColumn" adında bir sütun bulunmalıdır.
    Assert.AreEqual("Image:ImageColumn", field.FieldName);

    // Uygun bir veri kaynağı oluşturun.
    DataTable dataTable = new DataTable("Images");
    dataTable.Columns.Add(new DataColumn("ImageColumn"));
    dataTable.Rows.Add(ImageDir + "Logo.jpg");
    dataTable.Rows.Add(ImageDir + "Transparent background logo.png");
    dataTable.Rows.Add(ImageDir + "Enhanced Windows MetaFile.emf");

    // Birleştirme sırasında görüntülerin boyutlarını değiştirmek için bir geri arama yapılandırın, ardından adres-mektup birleştirmeyi yürütün.
    doc.MailMerge.FieldMergingCallback = new MergedImageResizer(200, 200, MergeFieldImageDimensionUnit.Point);
    doc.MailMerge.Execute(dataTable);

    doc.UpdateFields();
    doc.Save(ArtifactsDir + "Field.MERGEFIELD.ImageDimension.docx");
}

/// <summary>
/// Adres-postayla birleştirilmiş tüm görsellerin boyutunu tanımlanmış tek bir genişliğe ve yüksekliğe ayarlar.
/// </summary>
private class MergedImageResizer : IFieldMergingCallback
{
    public MergedImageResizer(double imageWidth, double imageHeight, MergeFieldImageDimensionUnit unit)
    {
        mImageWidth = imageWidth;
        mImageHeight = imageHeight;
        mUnit = unit;
    }

    public void FieldMerging(FieldMergingArgs e)
    {
        throw new NotImplementedException();
    }

    public void ImageFieldMerging(ImageFieldMergingArgs args)
    {
        args.ImageFileName = args.FieldValue.ToString();
        args.ImageWidth = new MergeFieldImageDimension(mImageWidth, mUnit);
        args.ImageHeight = new MergeFieldImageDimension(mImageHeight, mUnit);

        Assert.AreEqual(mImageWidth, args.ImageWidth.Value);
        Assert.AreEqual(mUnit, args.ImageWidth.Unit);
        Assert.AreEqual(mImageHeight, args.ImageHeight.Value);
        Assert.AreEqual(mUnit, args.ImageHeight.Unit);
    }

    private readonly double mImageWidth;
    private readonly double mImageHeight;
    private readonly MergeFieldImageDimensionUnit mUnit;
}

Ayrıca bakınız

IMailMergeDataSourceRoot Interface MailMerge Class