MailMergeSettings

MailMergeSettings class

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

Daha fazla bilgi edinmek için şu adresi ziyaret edin:Posta Birleştirme ve Raporlama belgeleme makalesi.

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 veri kaynağından gelen kaydın tek tabanlı dizinini belirtir. Varsayılan değer 1’dir.
AddressFieldName { get; set; }	Veri kaynağında e-posta adreslerini içeren sütunu belirtir. Varsayılan değer boş bir dizedir.
CheckErrors { get; set; }	Microsoft Word tarafından posta birleştirme işlemi gerçekleştirilirken gerçekleştirilecek hata raporlama türünü belirtir. Varsayılan değerDefault .
ConnectString { get; set; }	Harici bir veri kaynağına bağlanmak için kullanılan bağlantı dizesini belirtir. Varsayılan değer boş bir dizedir.
DataSource { get; set; }	Posta birleştirme veri kaynağına giden yolu belirtir. Varsayılan değer boş bir dizedir.
DataType { get; set; }	Posta birleştirme veri kaynağının türünü ve veri erişim yöntemini belirtir. Varsayılan değer:Default .
Destination { get; set; }	Microsoft Word’ün bir posta birleştirme işleminin sonuçlarını nasıl çıktı vereceğini belirtir. Varsayılan değerDefault .
DoNotSupressBlankLines { get; set; }	Posta birleştirme işlemini gerçekleştiren bir uygulamanın, posta birleştirme sonucunda birleştirilen belgelerdeki boş satırları nasıl işleyeceğini belirtir. Varsayılan değer:`YANLIŞ` .
HeaderSource { get; set; }	Posta birleştirme başlık kaynağına giden yolu belirtir. Varsayılan değer boş bir dizedir.
LinkToQuery { get; set; }	Bundan emin değilim. Microsoft Word Otomasyon Başvurusu, bunun sorgunun belgesi Microsoft Word’de her açıldığında yürütüleceğini belirttiğini öne sürüyor. Ancak OOXML belirtimi, bunun sorgunun gerçek sorguyu içeren harici bir sorgu dosyasına bir başvuru içerdiğini belirttiğini öne sürüyor. Varsayılan değer`YANLIŞ` .
MailAsAttachment { get; set; }	Bir posta birleştirme işlemi sırasında üretilen belgelerin gerçek e-postanın gövdesi yerine eki olarak e-postayla gönderilmesi gerektiğini belirtir. Varsayılan değer`YANLIŞ` .
MailSubject { get; set; }	Posta 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; }	Posta birleştirme ana belge türünü belirtir. Varsayılan değer:Default .
Odso { get; set; }	Office Veri Kaynağı Nesnesi (ODSO) ayarlarını belirten nesneyi alır veya ayarlar.
Query { get; set; }	Posta 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ülemesini belirtir (örneğin birleştirilmiş verileri önizleme). Varsayılan değer:`YANLIŞ` .

yöntemler

İsim	Tanım
Clear()	Belge kaydedildiğinde, hiçbir posta birleştirme ayarının kaydedilmeyeceği ve normal bir belge haline geleceği şekilde posta birleştirme ayarlarını temizler.
Clone()	Bu nesnenin derin bir klonunu döndürür.

Notlar

Bu nesneyi bir belge için bir posta birleştirme veri kaynağı belirtmek için kullanabilirsiniz ve bu bilgi (mevcut veri alanlarıyla birlikte) kullanıcı bu belgeyi açtığında Microsoft Word’de görünür. Veya bu nesneyi, kullanıcının bu belge için Microsoft Word’de belirttiği posta birleştirme ayarlarını sorgulamak için kullanabilirsiniz.

Bu sınıfın nesnelerini doğrudan oluşturmanız normalde gerekmez çünkü bir belgenin Posta birleştirme ayarları her zaman şu şekilde kullanılabilir:MailMergeSettings mülk.

Bu belgenin bir posta birleştirme ana belgesi olup olmadığını saptamak için değerini kontrol edinMainDocumentType mülk.

Bir belgeden posta birleştirme ayarlarını ve veri kaynağı bilgilerini kaldırmak için kullanabilirsinizClear yöntem. Aspose.Words, ise bir belgeye posta birleştirme ayarlarını yazmayacaktır.MainDocumentType mülk ayarlandıNotAMergeDocument veyaDataType mülk ayarlandıNone.

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

Aspose.Words, farklı biçimler arasında documents yüklerken, kaydederken ve dönüştürürken posta birleştirme bilgilerini korur, ancak kendi posta birleştirmesini kullanarak gerçekleştirirken bu bilgileri kullanmaz.MailMerge nesne.

Örnekler

Office Veri Kaynağı Nesnesi’ndeki verilerle bir posta 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>");

// "|" karakterini kullanarak ASCII dosyası biçiminde bir veri kaynağı oluşturun
// sütunları ayıran ayırıcı olarak işlev görür. İlk satır üç sütunun adlarını içerir,
// ve her bir sonraki 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çerikleri görüntülemeden önce posta birleştirme işlemini gerçekleştirecektir.
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

Ayrıca bakınız

ad alanı Aspose.Words.Settings
toplantı Aspose.Words

MailMergeMainDocumentType Enum MsWordVersion Enum