ExecuteWithRegions

ExecuteWithRegions(IMailMergeDataSource)

Adres-mektup birleştirme bölgelerine sahip özel bir veri kaynağından adres-mektup birleştirme gerçekleştirir.

public void ExecuteWithRegions(IMailMergeDataSource dataSource)

Parametre	Tip	Tanım
dataSource	IMailMergeDataSource	Özel adres-mektup birleştirme veri kaynağı arayüzünü uygulayan bir nesne.

Notlar

Belgedeki adres-mektup birleştirme alanlarını XML dosyası veya iş nesneleri koleksiyonları gibi herhangi bir özel veri kaynağından değerleriyle doldurmak için bu yöntemi kullanın. Bunu uygulayan your kendi sınıfını yazmanız gerekir.IMailMergeDataSource arayüz.

Bu yöntemi yalnızca şu durumlarda kullanabilirsiniz:IsBidiTextSupportedOnUpdate dır-dirYANLIŞ, yani Sağdan Sola dil (Arapça veya İbranice gibi) uyumluluğuna ihtiyacınız yoktur.

Örnekler

İç içe adres-mektup birleştirmeyi yürütmek için adres-mektup birleştirme bölgelerinin nasıl kullanılacağını gösterir.

public void CustomDataSource()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Normalde MERGEFIELD'ler, adres-mektup birleştirme veri kaynağının bir sütununun adını içerir.
    // Bunun yerine, adres-mektup birleştirme bölgesini başlatmak/sonlandırmak için "TableStart:" ve "TableEnd:" öneklerini kullanabiliriz.
    // Her bölge, önekin iki nokta üst üste işaretinden hemen sonraki dizeyle eşleşen ada sahip bir tabloya ait olacaktır.
    builder.InsertField(" MERGEFIELD TableStart:Customers");

    // Bu MERGEFIELD'ler "Müşteriler" tablosunun adres-mektup birleştirme bölgesinin içindedir.
    // Adres-mektup birleştirme işlemini yaptığımızda bu alan "Müşteriler" adlı bir veri kaynağındaki satırlardan veri alacaktır.
    builder.Write("Full name:\t");
    builder.InsertField(" MERGEFIELD FullName ");
    builder.Write("\nAddress:\t");
    builder.InsertField(" MERGEFIELD Address ");
    builder.Write("\nOrders:\n");

    // "Siparişler" adlı bir veri kaynağı için dış bölge içinde ikinci bir adres-mektup birleştirme bölgesi oluşturun.
    // "Siparişler" veri girişlerinin "Müşteriler" veri kaynağıyla birebir ilişkisi vardır.
    builder.InsertField(" MERGEFIELD TableStart:Orders");

    builder.Write("\tItem name:\t");
    builder.InsertField(" MERGEFIELD Name ");
    builder.Write("\n\tQuantity:\t");
    builder.InsertField(" MERGEFIELD Quantity ");
    builder.InsertParagraph();

    builder.InsertField(" MERGEFIELD TableEnd:Orders");
    builder.InsertField(" MERGEFIELD TableEnd:Customers");

    // Adres-mektup birleştirme bölgelerimizin adlarıyla eşleşen ilgili verileri oluşturun.
    CustomerList customers = new CustomerList();
    customers.Add(new Customer("Thomas Hardy", "120 Hanover Sq., London"));
    customers.Add(new Customer("Paolo Accorti", "Via Monte Bianco 34, Torino"));

    customers[0].Orders.Add(new Order("Rugby World Cup Cap", 2));
    customers[0].Orders.Add(new Order("Rugby World Cup Ball", 1));
    customers[1].Orders.Add(new Order("Rugby World Cup Guide", 1));

    // Veri kaynağınızdan adres-mektup birleştirme yapmak için onu IMailMergeDataSource arayüzünü uygulayan bir nesneye sarmalıyız.
    CustomerMailMergeDataSource customersDataSource = new CustomerMailMergeDataSource(customers);

    doc.MailMerge.ExecuteWithRegions(customersDataSource);

    doc.Save(ArtifactsDir + "NestedMailMergeCustom.CustomDataSource.docx");
}

/// <summary>
/// Uygulamanızdaki "veri varlığı" sınıfına bir örnek.
/// </summary>
public class Customer
{
    public Customer(string aFullName, string anAddress)
    {
        FullName = aFullName;
        Address = anAddress;
        Orders = new List<Order>();
    }

    public string FullName { get; set; }
    public string Address { get; set; }
    public List<Order> Orders { get; set; }
}

/// <summary>
/// "Veri" nesnelerinizi içeren yazılı bir koleksiyon örneği.
/// </summary>
public class CustomerList : ArrayList
{
    public new Customer this[int index]
    {
        get { return (Customer) base[index]; }
        set { base[index] = value; }
    }
}

/// <summary>
/// Uygulamanızdaki alt "veri varlığı" sınıfına bir örnek.
/// </summary>
public class Order
{
    public Order(string oName, int oQuantity)
    {
        Name = oName;
        Quantity = oQuantity;
    }

    public string Name { get; set; }
    public int Quantity { get; set; }
}

/// <summary>
 /// Aspose.Words'e izin vermek için uyguladığınız özel bir adres-mektup birleştirme veri kaynağı
/// Müşteri nesnelerinizdeki posta birleştirme verilerini Microsoft Word belgelerine aktarmak için.
/// </summary>
public class CustomerMailMergeDataSource : IMailMergeDataSource
{
    public CustomerMailMergeDataSource(CustomerList customers)
    {
        mCustomers = customers;

        // Veri kaynağını başlattığımızda konumu ilk kayıttan önce olmalıdır.
        mRecordIndex = -1;
    }

    /// <summary>
    /// Veri kaynağının adı. Aspose.Words tarafından yalnızca tekrarlanabilir bölgelerle adres-mektup birleştirme yürütülürken kullanılır.
    /// </summary>
    public string TableName
    {
        get { return "Customers"; }
    }

    /// <summary>
    /// Aspose.Words her veri alanı için bir değer elde etmek amacıyla bu yöntemi çağırır.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "FullName":
                fieldValue = mCustomers[mRecordIndex].FullName;
                return true;
            case "Address":
                fieldValue = mCustomers[mRecordIndex].Address;
                return true;
            case "Order":
                fieldValue = mCustomers[mRecordIndex].Orders;
                return true;
            default:
                // Aspose.Words adres-mektup birleştirme motoruna şunu belirtmek için "yanlış" değerini döndürün
                // bu isimde bir alan bulamadık.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Koleksiyondaki bir sonraki kayda geçmek için standart bir uygulama.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        switch (tableName)
        {
            // Adı, sütunlarını kullanan adres-mektup birleştirme bölgesiyle eşleşen alt veri kaynağını alın.
            case "Orders":
                return new OrderMailMergeDataSource(mCustomers[mRecordIndex].Orders);
            default:
                return null;
        }
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mCustomers.Count); }
    }

    private readonly CustomerList mCustomers;
    private int mRecordIndex;
}

public class OrderMailMergeDataSource : IMailMergeDataSource
{
    public OrderMailMergeDataSource(List<Order> orders)
    {
        mOrders = orders;

        // Veri kaynağını başlattığımızda konumu ilk kayıttan önce olmalıdır.
        mRecordIndex = -1;
    }

    /// <summary>
    /// Veri kaynağının adı. Aspose.Words tarafından yalnızca tekrarlanabilir bölgelerle adres-mektup birleştirme yürütülürken kullanılır.
    /// </summary>
    public string TableName
    {
        get { return "Orders"; }
    }

    /// <summary>
    /// Aspose.Words her veri alanı için bir değer elde etmek amacıyla bu yöntemi çağırır.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "Name":
                fieldValue = mOrders[mRecordIndex].Name;
                return true;
            case "Quantity":
                fieldValue = mOrders[mRecordIndex].Quantity;
                return true;
            default:
                // Aspose.Words adres-mektup birleştirme motoruna şunu belirtmek için "yanlış" değerini döndürün
                // bu isimde bir alan bulamadık.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Koleksiyondaki bir sonraki kayda geçmek için standart bir uygulama.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    /// <summary>
    /// null değerini döndür çünkü bu tür bir nesne için herhangi bir alt öğemiz yok.
    /// </summary>
    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        return null;
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mOrders.Count); }
    }

    private readonly List<Order> mOrders;
    private int mRecordIndex;
}

Ayrıca bakınız

• interface IMailMergeDataSource
• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words

---

ExecuteWithRegions(IMailMergeDataSourceRoot)

Adres-mektup birleştirme bölgelerine sahip özel bir veri kaynağından adres-mektup birleştirme gerçekleştirir.

public void ExecuteWithRegions(IMailMergeDataSourceRoot dataSourceRoot)

Parametre	Tip	Tanım
dataSourceRoot	IMailMergeDataSourceRoot	Özel adres-mektup birleştirme veri kaynağı kök arayüzünü uygulayan bir nesne.

Notlar

Belgedeki adres-mektup birleştirme alanlarını XML dosyası veya iş nesneleri koleksiyonları gibi herhangi bir özel veri kaynağından değerleriyle doldurmak için bu yöntemi kullanın. Bunu uygulayan kendi class dosyanızı yazmanız gerekir.IMailMergeDataSourceRoot VeIMailMergeDataSource arayüzler.

Bu yöntemi yalnızca şu durumlarda kullanabilirsiniz:IsBidiTextSupportedOnUpdate dır-dirYANLIŞ, yani Sağdan Sola dil (Arapça veya İbranice gibi) uyumluluğuna ihtiyacınız yoktur.

Örnekler

Ana ayrıntı verileriyle özel bir veri kaynağından adres-mektup birleştirme gerçekleştirir.

public void CustomDataSourceRoot()
{
    // "Washington" ve "Seattle" adlı iki adres-mektup birleştirme bölgesine sahip bir belge oluşturun.
    string[] mailMergeRegions = { "Vancouver", "Seattle" };
    Document doc = CreateSourceDocumentWithMailMergeRegions(mailMergeRegions);

    // Adres-mektup birleştirme için iki veri kaynağı oluşturun.
    EmployeeList employeesWashingtonBranch = new EmployeeList();
    employeesWashingtonBranch.Add(new Employee("John Doe", "Sales"));
    employeesWashingtonBranch.Add(new Employee("Jane Doe", "Management"));

    EmployeeList employeesSeattleBranch = new EmployeeList();
    employeesSeattleBranch.Add(new Employee("John Cardholder", "Management"));
    employeesSeattleBranch.Add(new Employee("Joe Bloggs", "Sales"));

    // Veri kaynaklarımızı bir veri kaynağı köküne ada göre kaydedin.
    // Bu veri kaynağı kökünü bölgelerle adres-mektup birleştirmede kullanmak üzereysek,
    // her kaynağın kayıtlı adı, adres-mektup birleştirme kaynak belgesindeki mevcut adres-mektup birleştirme bölgesinin adıyla eşleşmelidir.
    DataSourceRoot sourceRoot = new DataSourceRoot();
    sourceRoot.RegisterSource(mailMergeRegions[0], new EmployeeListMailMergeSource(employeesWashingtonBranch));
    sourceRoot.RegisterSource(mailMergeRegions[1], new EmployeeListMailMergeSource(employeesSeattleBranch));

    // Ardışık adres-mektup birleştirme bölgelerimiz olduğundan normalde iki adres-mektup birleştirme yapmamız gerekir.
    // Ancak, veri köküne sahip bir adres-mektup birleştirme kaynağı birden fazla bölgeyi doldurabilir
    // eğer kök karşılık gelen adlara/sütun adlarına sahip tablolar içeriyorsa.
    doc.MailMerge.ExecuteWithRegions(sourceRoot);

    doc.Save(ArtifactsDir + "MailMergeCustom.CustomDataSourceRoot.docx");
}

/// <summary>
/// Giriş dizisi tarafından belirlenen adlarla ardışık adres-mektup birleştirme bölgelerini içeren bir belge oluşturun,
/// çalışanların veri tablosu için.
/// </summary>
private static Document CreateSourceDocumentWithMailMergeRegions(string[] regions)
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    foreach (string s in regions)
    {
        builder.Writeln("\n" + s + " branch: ");
        builder.InsertField(" MERGEFIELD TableStart:" + s);
        builder.InsertField(" MERGEFIELD FullName");
        builder.Write(", ");
        builder.InsertField(" MERGEFIELD Department");
        builder.InsertField(" MERGEFIELD TableEnd:" + s);
    }

    return doc;
}

/// <summary>
/// Uygulamanızdaki "veri varlığı" sınıfına bir örnek.
/// </summary>
private class Employee
{
    public Employee(string aFullName, string aDepartment)
    {
        FullName = aFullName;
        Department = aDepartment;
    }

    public string FullName { get; }
    public string Department { get; }
}

/// <summary>
/// "Veri" nesnelerinizi içeren yazılı bir koleksiyon örneği.
/// </summary>
private class EmployeeList : ArrayList
{
    public new Employee this[int index]
    {
        get { return (Employee)base[index]; }
        set { base[index] = value; }
    }
}

/// <summary>
/// Birçok alt veri kaynağını kaydedebilen ve içerebilen adres-mektup birleştirmeye doğrudan aktarılabilen veri kaynağı kökü.
/// Bu kaynakların tümü IMailMergeDataSource'u uygulamalı ve bir adla kaydedilip farklılaştırılmalıdır
/// ilgili verileri okuyacak adres-mektup birleştirme bölgesine karşılık gelir.
/// </summary>
private class DataSourceRoot : IMailMergeDataSourceRoot
{
    public IMailMergeDataSource GetDataSource(string tableName)
    {
        EmployeeListMailMergeSource source = mSources[tableName];
        source.Reset();
        return mSources[tableName];
    }

    public void RegisterSource(string sourceName, EmployeeListMailMergeSource source)
    {
        mSources.Add(sourceName, source);
    }

    private readonly Dictionary<string, EmployeeListMailMergeSource> mSources = new Dictionary<string, EmployeeListMailMergeSource>();
}

/// <summary>
/// Özel adres-mektup birleştirme veri kaynağı.
/// </summary>
private class EmployeeListMailMergeSource : IMailMergeDataSource
{
    public EmployeeListMailMergeSource(EmployeeList employees)
    {
        mEmployees = employees;
        mRecordIndex = -1;
    }

    /// <summary>
    /// Koleksiyondaki bir sonraki kayda geçmek için standart bir uygulama.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mEmployees.Count); }
    }

    public void Reset()
    {
        mRecordIndex = -1;
    }

    /// <summary>
    /// Veri kaynağının adı. Aspose.Words tarafından yalnızca tekrarlanabilir bölgelerle adres-mektup birleştirme yürütülürken kullanılır.
    /// </summary>
    public string TableName
    {
        get { return "Employees"; }
    }

    /// <summary>
    /// Aspose.Words her veri alanı için bir değer elde etmek amacıyla bu yöntemi çağırır.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "FullName":
                fieldValue = mEmployees[mRecordIndex].FullName;
                return true;
            case "Department":
                fieldValue = mEmployees[mRecordIndex].Department;
                return true;
            default:
                // Aspose.Words adres-mektup birleştirme motoruna şunu belirtmek için "yanlış" değerini döndürün
                // bu isimde bir alan bulamadık.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Alt veri kaynakları iç içe adres-mektup birleştirmeler içindir.
    /// </summary>
    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        throw new System.NotImplementedException();
    }

    private readonly EmployeeList mEmployees;
    private int mRecordIndex;
}

Ayrıca bakınız

• interface IMailMergeDataSourceRoot
• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words

---

ExecuteWithRegions(DataSet)

Adres-mektup birleştirmeyi bir adresten gerçekleştirir.Veri Kümesi adres-mektup birleştirme bölgeleri olan bir belgeye.

public void ExecuteWithRegions(DataSet dataSet)

Parametre	Tip	Tanım
dataSet	DataSet	Veri Kümesi Adres-mektup birleştirme alanlarına eklenecek verileri içeren.

Notlar

Bir veya daha fazla tablodan belgedeki tekrarlanabilir mail birleştirme bölgelerine adres-mektup birleştirme gerçekleştirmek için bu yöntemi kullanın. Belgenin içindeki adres-mektup birleştirme bölgeleri, karşılık gelen tablolardaki kayıtları barındıracak şekilde dinamik büyüyecektir.

Her masadaVeri Kümesi bir ismi olmalı.

Belgenin, tablodaki tablo ‘ye başvuran adlarla tanımlanmış adres-mektup birleştirme bölgelerine sahip olması gerekir.Veri Kümesi.

Belgede bir adres-mektup birleştirme bölgesi belirtmek için, adres-mektup birleştirme bölgesinin başlangıcını ve sonunu işaretlemek üzere iki adres-mektup birleştirme alanı eklemeniz gerekir.

Adres-mektup birleştirme bölgesine dahil edilen tüm belge içeriği, bölgedeki her kayıt için otomatik olarak tekrarlanacaktır.Veri tablosu.

Adres-mektup birleştirme bölgesinin başlangıcını işaretlemek için TableStart:MyTable, adında bir MERGEFIELD ekleyin; burada MyTable, tablonuzdaki tablo adlarından birine karşılık gelir.Veri Kümesi.

Adres-mektup birleştirme bölgesinin sonunu işaretlemek için TableEnd:MyTable adında başka bir MERGEFIELD ekleyin.

Word’e bir MERGEFIELD eklemek için Ekle/Alan komutunu kullanın ve MergeField’ı seçin ve ardından alanın adını yazın.

TabloBaşlangıcı VeTablo Sonu alanlar belgenizde aynı bölümün içinde olmalıdır.

Bir masanın içinde kullanılıyorsa,TabloBaşlangıcı VeTablo Sonu tabloda aynı satırda olmalıdır.

Bir belgedeki adres-mektup birleştirme bölgeleri iyi biçimlendirilmiş olmalıdır (her zaman bir çift eşleşen olması gerekir)TabloBaşlangıcı VeTablo Sonu aynı tablo adına sahip alanları birleştirin).

Örnekler

İki birleştirme bölgesi ve iki veri tablosuyla iç içe adres-mektup birleştirmenin nasıl yürütüleceğini gösterir.

public void ExecuteWithRegionsNested()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Normalde MERGEFIELD'ler, adres-mektup birleştirme veri kaynağının bir sütununun adını içerir.
    // Bunun yerine, adres-mektup birleştirme bölgesini başlatmak/sonlandırmak için "TableStart:" ve "TableEnd:" öneklerini kullanabiliriz.
    // Her bölge, önekin iki nokta üst üste işaretinden hemen sonraki dizeyle eşleşen ada sahip bir tabloya ait olacaktır.
    builder.InsertField(" MERGEFIELD TableStart:Customers");

    // Bu MERGEFIELD, "Müşteriler" tablosunun adres-mektup birleştirme bölgesinin içindedir.
    // Adres-mektup birleştirme işlemini yaptığımızda bu alan "Müşteriler" adlı bir veri kaynağındaki satırlardan veri alacaktır.
    builder.Write("Orders for ");
    builder.InsertField(" MERGEFIELD CustomerName");
    builder.Write(":");

    // İkinci bir iç bölgeden değerleri içerecek bir tablo için sütun başlıkları oluşturun.
    builder.StartTable();
    builder.InsertCell();
    builder.Write("Item");
    builder.InsertCell();
    builder.Write("Quantity");
    builder.EndRow();

    // "Siparişler" adlı tablo için dış bölgenin içinde ikinci bir adres-mektup birleştirme bölgesi oluşturun.
    // "Siparişler" tablosunun "MüşteriKimliği" sütunundaki "Müşteriler" tablosuyla birebir ilişkisi vardır.
    builder.InsertCell();
    builder.InsertField(" MERGEFIELD TableStart:Orders");
    builder.InsertField(" MERGEFIELD ItemName");
    builder.InsertCell();
    builder.InsertField(" MERGEFIELD Quantity");

    // İç bölgeyi sonlandırın ve ardından dış bölgeyi sonlandırın. Adres-mektup birleştirme bölgesinin açılması ve kapatılması
    // tablonun aynı satırında gerçekleşir.
    builder.InsertField(" MERGEFIELD TableEnd:Orders");
    builder.EndTable();

    builder.InsertField(" MERGEFIELD TableEnd:Customers");

    // Gerekli adlara ve ilişkilere sahip iki tabloyu içeren bir veri kümesi oluşturun.
    // Dış birleştirme bölgesinin "Müşteriler" tablosunun her satırı için her birleştirme belgesi, adres-mektup birleştirme işlemini "Siparişler" tablosunda gerçekleştirecektir.
    // Her birleştirme belgesi, "MüşteriKimliği" sütun değerleri geçerli "Müşteriler" tablosu satırıyla eşleşen ikinci tablonun tüm satırlarını görüntüler.
    DataSet customersAndOrders = CreateDataSet();
    doc.MailMerge.ExecuteWithRegions(customersAndOrders);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteWithRegionsNested.docx");
}

/// <summary>
/// "Müşteriler" ve "Siparişler" adlı iki veri tablosuna sahip, "MüşteriKimliği" sütununda bire-çok ilişkisi olan bir veri seti oluşturur.
/// </summary>
private static DataSet CreateDataSet()
{
    DataTable tableCustomers = new DataTable("Customers");
    tableCustomers.Columns.Add("CustomerID");
    tableCustomers.Columns.Add("CustomerName");
    tableCustomers.Rows.Add(new object[] { 1, "John Doe" });
    tableCustomers.Rows.Add(new object[] { 2, "Jane Doe" });

    DataTable tableOrders = new DataTable("Orders");
    tableOrders.Columns.Add("CustomerID");
    tableOrders.Columns.Add("ItemName");
    tableOrders.Columns.Add("Quantity");
    tableOrders.Rows.Add(new object[] { 1, "Hawaiian", 2 });
    tableOrders.Rows.Add(new object[] { 2, "Pepperoni", 1 });
    tableOrders.Rows.Add(new object[] { 2, "Chicago", 1 });

    DataSet dataSet = new DataSet();
    dataSet.Tables.Add(tableCustomers);
    dataSet.Tables.Add(tableOrders);
    dataSet.Relations.Add(tableCustomers.Columns["CustomerID"], tableOrders.Columns["CustomerID"]);

    return dataSet;
}

Ayrıca bakınız

• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words

---

ExecuteWithRegions(DataTable)

Adres-mektup birleştirmeyi bir adresten gerçekleştirir.Veri tablosu adres-mektup birleştirme bölgelerinin bulunduğu belgeye.

public void ExecuteWithRegions(DataTable dataTable)

Parametre	Tip	Tanım
dataTable	DataTable	Adres-mektup birleştirme işlemi için veri kaynağı. Tablonun olması gerekirTableName özellik seti.

Notlar

Belgenin, ile eşleşen adla tanımlanmış bir adres-mektup birleştirme bölgesine sahip olması gerekirTableName.

Belgede tanımlanmış başka adres-mektup birleştirme bölgeleri varsa, bunlar olduğu gibi bırakılır. Bu, birden fazla adres-mektup birleştirme işleminin gerçekleştirilmesine olanak sağlar.

Örnekler

Adres-mektup birleştirme sırasında hücrelerin nasıl biçimlendirileceğini gösterir.

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

    doc.MailMerge.FieldMergingCallback = new HandleMergeFieldAlternatingRows();

    DataTable dataTable = GetSuppliersDataTable();
    doc.MailMerge.ExecuteWithRegions(dataTable);

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

/// <summary>
/// Tablo satırlarını, tek/çift satırlarda iki renk arasında geçiş yapmak üzere adres-mektup birleştirme gerçekleştiği için biçimlendirir.
/// </summary>
private class HandleMergeFieldAlternatingRows : IFieldMergingCallback
{
    /// <summary>
    /// Adres-mektup birleştirme verileri MERGEFIELD ile birleştirdiğinde çağrılır.
    /// </summary>
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (mBuilder == null)
            mBuilder = new DocumentBuilder(args.Document);

        // Bu ilk sütunda olduğumuz için geçerlidir, bu da yeni bir satıra geçtiğimiz anlamına gelir.
        if (args.FieldName == "CompanyName")
        {
            Color rowColor = IsOdd(mRowIdx) ? Color.FromArgb(213, 227, 235) : Color.FromArgb(242, 242, 242);

            for (int colIdx = 0; colIdx < 4; colIdx++)
            {
                mBuilder.MoveToCell(0, mRowIdx, colIdx, 0);
                mBuilder.CellFormat.Shading.BackgroundPatternColor = rowColor;
            }

            mRowIdx++;
        }
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // Hiçbir şey yapma.
    }

    private DocumentBuilder mBuilder;
    private int mRowIdx;
}

/// <summary>
/// Geçirilen sayının eşliğini döndüren Visual Basic otomatik taşıması için gereken işlev.
/// </summary>
private static bool IsOdd(int value)
{
    return (value / 2 * 2).Equals(value);
}

/// <summary>
/// Adres-mektup birleştirme veri kaynağı oluşturur.
/// </summary>
private static DataTable GetSuppliersDataTable()
{
    DataTable dataTable = new DataTable("Suppliers");
    dataTable.Columns.Add("CompanyName");
    dataTable.Columns.Add("ContactName");
    for (int i = 0; i < 10; i++)
    {
        DataRow datarow = dataTable.NewRow();
        dataTable.Rows.Add(datarow);
        datarow[0] = "Company " + i;
        datarow[1] = "Contact " + i;
    }

    return dataTable;
}

Tek bir belgede iki ayrı adres-mektup birleştirmeyi yürütmek için bölgelerin nasıl kullanılacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// İki tablodan veri alırken tek belge üzerinde ardı ardına iki adres-mektup birleştirme yapmak istiyorsak
// herhangi bir şekilde birbiriyle ilişkili olan adres-mektup birleştirmeleri bölgelere ayırabiliriz.
// Normalde MERGEFIELD'ler, adres-mektup birleştirme veri kaynağının bir sütununun adını içerir.
// Bunun yerine, adres-mektup birleştirme bölgesini başlatmak/sonlandırmak için "TableStart:" ve "TableEnd:" öneklerini kullanabiliriz.
// Her bölge, önekin iki nokta üst üste işaretinden hemen sonraki dizeyle eşleşen ada sahip bir tabloya ait olacaktır.
// Bu bölgeler ilgisiz veriler için ayrıdır, hiyerarşik veriler için ise iç içe yerleştirilebilir.
builder.Writeln("\tCities: ");
builder.InsertField(" MERGEFIELD TableStart:Cities");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Cities");
builder.InsertParagraph();

// Her iki MERGEFIELD aynı sütun adını ifade eder, ancak her birinin değerleri farklı veri tablolarından gelecektir.
builder.Writeln("\tFruit: ");
builder.InsertField(" MERGEFIELD TableStart:Fruit");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Fruit");

//İki ilgisiz veri tablosu oluşturun.
DataTable tableCities = new DataTable("Cities");
tableCities.Columns.Add("Name");
tableCities.Rows.Add(new object[] { "Washington" });
tableCities.Rows.Add(new object[] { "London" });
tableCities.Rows.Add(new object[] { "New York" });

DataTable tableFruit = new DataTable("Fruit");
tableFruit.Columns.Add("Name");
tableFruit.Rows.Add(new object[] { "Cherry" });
tableFruit.Rows.Add(new object[] { "Apple" });
tableFruit.Rows.Add(new object[] { "Watermelon" });
tableFruit.Rows.Add(new object[] { "Banana" });

// Tablo başına bir adres-mektup birleştirme çalıştırmamız gerekecek. İlk adres-mektup birleştirme MERGEFIELD'leri dolduracak
// "Şehirler" aralığında, "Meyve" aralığını doldurmadan bırakıyoruz.
doc.MailMerge.ExecuteWithRegions(tableCities);

// Veri görünümünü kullanırken "Meyve" tablosu için ikinci bir birleştirme çalıştırın
// birleştirme işleminden önce "Ad" sütunundaki satırları artan sırada sıralamak için.
DataView dv = new DataView(tableFruit);
dv.Sort = "Name ASC";
doc.MailMerge.ExecuteWithRegions(dv);

doc.Save(ArtifactsDir + "MailMerge.ExecuteWithRegionsConcurrent.docx");

Ayrıca bakınız

• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words

---

ExecuteWithRegions(DataView)

Adres-mektup birleştirmeyi bir adresten gerçekleştirir.Veri görünümü adres-mektup birleştirme bölgelerinin bulunduğu belgeye.

public void ExecuteWithRegions(DataView dataView)

Parametre	Tip	Tanım
dataView	DataView	Adres-mektup birleştirme işlemi için veri kaynağı. Kaynak table Veri görünümü ona sahip olmalıTablo ismi özellik seti.

Notlar

Bu yöntem, verileri bir dosyaya alırsanız kullanışlıdır.Veri tablosu ancak Then adres-mektup birleştirmeden önce bir filtre uygulamanız veya sıralamanız gerekir.

Belgenin, ile eşleşen adla tanımlanmış bir adres-mektup birleştirme bölgesine sahip olması gerekirDataView.Table.TableName.

Belgede tanımlanmış başka adres-mektup birleştirme bölgeleri varsa, bunlar olduğu gibi bırakılır. Bu, birden fazla adres-mektup birleştirme işleminin gerçekleştirilmesine olanak sağlar.

Örnekler

Tek bir belgede iki ayrı adres-mektup birleştirmeyi yürütmek için bölgelerin nasıl kullanılacağını gösterir.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// İki tablodan veri alırken tek belge üzerinde ardı ardına iki adres-mektup birleştirme yapmak istiyorsak
// herhangi bir şekilde birbiriyle ilişkili olan adres-mektup birleştirmeleri bölgelere ayırabiliriz.
// Normalde MERGEFIELD'ler, adres-mektup birleştirme veri kaynağının bir sütununun adını içerir.
// Bunun yerine, adres-mektup birleştirme bölgesini başlatmak/sonlandırmak için "TableStart:" ve "TableEnd:" öneklerini kullanabiliriz.
// Her bölge, önekin iki nokta üst üste işaretinden hemen sonraki dizeyle eşleşen ada sahip bir tabloya ait olacaktır.
// Bu bölgeler ilgisiz veriler için ayrıdır, hiyerarşik veriler için ise iç içe yerleştirilebilir.
builder.Writeln("\tCities: ");
builder.InsertField(" MERGEFIELD TableStart:Cities");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Cities");
builder.InsertParagraph();

// Her iki MERGEFIELD aynı sütun adını ifade eder, ancak her birinin değerleri farklı veri tablolarından gelecektir.
builder.Writeln("\tFruit: ");
builder.InsertField(" MERGEFIELD TableStart:Fruit");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Fruit");

//İki ilgisiz veri tablosu oluşturun.
DataTable tableCities = new DataTable("Cities");
tableCities.Columns.Add("Name");
tableCities.Rows.Add(new object[] { "Washington" });
tableCities.Rows.Add(new object[] { "London" });
tableCities.Rows.Add(new object[] { "New York" });

DataTable tableFruit = new DataTable("Fruit");
tableFruit.Columns.Add("Name");
tableFruit.Rows.Add(new object[] { "Cherry" });
tableFruit.Rows.Add(new object[] { "Apple" });
tableFruit.Rows.Add(new object[] { "Watermelon" });
tableFruit.Rows.Add(new object[] { "Banana" });

// Tablo başına bir adres-mektup birleştirme çalıştırmamız gerekecek. İlk adres-mektup birleştirme MERGEFIELD'leri dolduracak
// "Şehirler" aralığında, "Meyve" aralığını doldurmadan bırakıyoruz.
doc.MailMerge.ExecuteWithRegions(tableCities);

// Veri görünümünü kullanırken "Meyve" tablosu için ikinci bir birleştirme çalıştırın
// birleştirme işleminden önce "Ad" sütunundaki satırları artan sırada sıralamak için.
DataView dv = new DataView(tableFruit);
dv.Sort = "Name ASC";
doc.MailMerge.ExecuteWithRegions(dv);

doc.Save(ArtifactsDir + "MailMerge.ExecuteWithRegionsConcurrent.docx");

Ayrıca bakınız

• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words

---

ExecuteWithRegions(IDataReader, string)

Adres-mektup birleştirmeyi şuradan gerçekleştirir:IDataReader adres-mektup birleştirme bölgelerinin bulunduğu belgeye.

public void ExecuteWithRegions(IDataReader dataReader, string tableName)

Parametre	Tip	Tanım
dataReader	IDataReader	Adres-mektup birleştirmeye ilişkin veri kayıtlarının kaynağı, örneğinOleDbDataReader veyaSqlDataReader.
tableName	String	Doldurulacak belgedeki adres-mektup birleştirme bölgesinin adı.

Notlar

GeçebilirsinSqlDataReader veyaOleDbDataReaderthis yöntemine parametre olarak itiraz edin çünkü ikisi de uygulandıIDataReader arayüz.

Ö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;
    }
}

Ayrıca bakınız

• class MailMerge
• ad alanı Aspose.Words.MailMerging
• toplantı Aspose.Words