MailMergeSettings

MailMergeSettings class

Bir belge için tüm adres mektup birleştirme bilgilerini belirtir.

public class MailMergeSettings

yapıcılar

İsim Tanım
MailMergeSettings() Default_Constructor

Özellikleri

İsim Tanım
ActiveRecord { get; set; } Microsoft Word’de görüntülenecek olan veri kaynağından kaydın tek tabanlı dizinini belirtir. Varsayılan değer 1. ‘dir
AddressFieldName { get; set; } Veri kaynağındaki e-posta adreslerini içeren sütunu belirtir. Varsayılan değer boş bir dizedir.
CheckErrors { get; set; } Adres mektup birleştirme gerçekleştirirken Microsoft Word tarafından yürütülecek hata raporlama türünü belirtir. Varsayılan değerDefault .
ConnectString { get; set; } Bir dış veri kaynağına bağlanmak için kullanılan bağlantı dizesini belirtir. Varsayılan değer boş bir dizedir.
DataSource { get; set; } Adres mektup birleştirme veri kaynağının yolunu belirtir. Varsayılan değer boş bir dizedir.
DataType { get; set; } Adres mektup birleştirme veri kaynağının türünü ve veri erişim yöntemini belirtir. Varsayılan değerDefault .
Destination { get; set; } Microsoft Word’ün adres mektup birleştirme sonuçlarının nasıl çıktısını alacağını belirtir. Varsayılan değerDefault .
DoNotSupressBlankLines { get; set; } Adres mektup birleştirme gerçekleştiren bir uygulamanın, birleştirilmiş belgelerde adres mektup birleştirmeden kaynaklanan boş satırları nasıl işleyeceğini belirtir. Varsayılan değeryanlış .
HeaderSource { get; set; } Adres mektup birleştirme üstbilgi kaynağının yolunu belirtir. Varsayılan değer boş bir dizedir.
LinkToQuery { get; set; } Bundan emin değilim. Microsoft Word Otomasyon Referansı, bunun sorgunun belgesi Microsoft Word’de her açıldığında yürütüldüğünü belirttiğini belirtir. Ancak OOXML belirtimi, bunun, sorgunun gerçek sorguyu içeren harici bir sorgu dosyasına referans içerdiğini belirttiğini belirtir. Varsayılan değeryanlış .
MailAsAttachment { get; set; } Adres mektup birleştirme işlemi sırasında üretilen belgelerin, asıl e-postanın gövdesi yerine eki olarak e-postayla gönderilmesi gerektiğini belirtir. Varsayılan değeryanlış .
MailSubject { get; set; } Adres mektup birleştirme sırasında üretilen e-postaların veya faksların konu satırında görünecek metni belirtir. Varsayılan değer boş bir dizedir.
MainDocumentType { get; set; } Adres mektup birleştirme ana belge türünü belirtir. Varsayılan değerDefault .
Odso { get; set; } Office Veri Kaynağı Nesnesi (ODSO) ayarlarını belirten nesneyi alır veya ayarlar.
Query { get; set; } Adres mektup birleştirme işlemi gerçekleştirildiğinde belgeye aktarılacak kayıt kümesini döndürmek için belirtilen harici veri kaynağına karşı çalıştırılacak Yapılandırılmış Sorgu Dili dizesini içerir. Varsayılan değer boş bir dizedir.
ViewMergedData { get; set; } Microsoft Word’ün, birleştirme alanlarının eklendiği belirtilen harici veri kaynağından gelen verileri görüntüleyeceğini belirtir (örneğin, birleştirilmiş verileri önizleme). Varsayılan değeryanlış .

yöntemler

İsim Tanım
Clear() Adres mektup birleştirme ayarlarını, belge kaydedildiğinde hiçbir adres mektup birleştirme ayarı kaydedilmeyecek ve normal bir belge haline gelecek şekilde temizler.
Clone() Bu nesnenin derin bir klonunu döndürür.

Notlar

Bir belge için adres mektup birleştirme veri kaynağı belirtmek için bu nesneyi kullanabilirsiniz ve bu bilgi (kullanılabilir veri alanlarıyla birlikte) kullanıcı bu belgeyi açtığında Microsoft Word’de görünecektir. Veya bu nesneyi adres mektup birleştirme ayarlarını sorgulamak için kullanabilirsiniz. kullanıcının bu belge için Microsoft Word içinde belirttiği.

Bir belgenin Adres mektup birleştirme ayarları her zamanMailMergeSettings Emlak.

Bu belgenin adres mektup birleştirme ana belgesi olup olmadığını saptamak için değerini kontrol edin.MainDocumentType Emlak.

Adres mektup birleştirme ayarlarını ve veri kaynağı bilgilerini bir belgeden kaldırmak için Clear yöntem. Aspose.Words adres mektup birleştirme ayarlarını bir belgeye MainDocumentType özellik olarak ayarlandıNotAMergeDocument veyaDataType özellik olarak ayarlandıNone.

Bu nesnenin özelliklerinin nasıl kullanılacağını öğrenmenin en iyi yolu, istenen veri kaynağına sahip bir belgeyi Microsoft Word’de manuel olarak oluşturmak ve ardından bu belgeyi Aspose.Words kullanarak açmak ve o belgenin özelliklerini incelemektir.MailMergeSettings veOdso nesneler. Örneğin, bir veri kaynağını programlı olarak nasıl yapılandıracağınızı öğrenmek istiyorsanız, bu iyi bir yaklaşımdır.

Aspose.Words, belgeler ‘yi farklı biçimler arasında yüklerken, kaydederken ve dönüştürürken adres mektup birleştirme bilgilerini korur, ancakMailMerge nesne.

Örnekler

Office Veri Kaynağı Nesnesindeki verilerle adres mektup birleştirmenin nasıl yürütüleceğini gösterir.

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

builder.Write("Dear ");
builder.InsertField("MERGEFIELD FirstName", "<FirstName>");
builder.Write(" ");
builder.InsertField("MERGEFIELD LastName", "<LastName>");
builder.Writeln(": ");
builder.InsertField("MERGEFIELD Message", "<Message>");

// "|" ile ASCII dosyası biçiminde bir veri kaynağı oluşturun karakter
// sütunları ayıran sınırlayıcı görevi görür. İlk satır, üç sütunun adını içerir,
// ve sonraki her satır, kendi değerlerine sahip bir satırdır.
string[] lines = { "FirstName|LastName|Message",
    "John|Doe|Hello! This message was created with Aspose Words mail merge." };
string dataSrcFilename = ArtifactsDir + "MailMerge.MailMergeSettings.DataSource.txt";

File.WriteAllLines(dataSrcFilename, lines);

MailMergeSettings settings = doc.MailMergeSettings;
settings.MainDocumentType = MailMergeMainDocumentType.MailingLabels;
settings.CheckErrors = MailMergeCheckErrors.Simulate;
settings.DataType = MailMergeDataType.Native;
settings.DataSource = dataSrcFilename;
settings.Query = "SELECT * FROM " + doc.MailMergeSettings.DataSource;
settings.LinkToQuery = true;
settings.ViewMergedData = true;

Assert.AreEqual(MailMergeDestination.Default, settings.Destination);
Assert.False(settings.DoNotSupressBlankLines);

Odso odso = settings.Odso;
odso.DataSource = dataSrcFilename;
odso.DataSourceType = OdsoDataSourceType.Text;
odso.ColumnDelimiter = '|';
odso.FirstRowContainsColumnNames = true;

Assert.AreNotSame(odso, odso.Clone());
Assert.AreNotSame(settings, settings.Clone());

// Bu belgeyi Microsoft Word'de açmak, içeriği görüntülemeden önce adres mektup birleştirmeyi yürütecektir. 
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

Ayrıca bakınız