FieldMergeField
İçindekiler
[
Saklamak
]FieldMergeField class
MERGEFIELD alanını uygular.
Daha fazlasını öğrenmek için şu adresi ziyaret edin:Alanlarla Çalışmak dokümantasyon makalesi.
public class FieldMergeField : Field
Özellikleri
İsim | Tanım |
---|---|
DisplayResult { get; } | Görüntülenen alan sonucunu temsil eden metni alır. |
End { get; } | Alan sonunu temsil eden düğümü alır. |
FieldName { get; set; } | Bir veri alanının adını alır veya ayarlar. |
FieldNameNoPrefix { get; } | Yalnızca veri alanının adını döndürür. Herhangi bir önek, önek özelliğine çıkarılır. |
Format { get; } | Bir alırFieldFormat Alanın formatlamasına yazılı erişim sağlayan nesne. |
IsDirty { get; set; } | Belgede yapılan diğer değişiklikler nedeniyle alanın geçerli sonucunun artık doğru (eski) olup olmadığını alır veya ayarlar. |
IsLocked { get; set; } | Alanın kilitli olup olmadığını alır veya ayarlar (sonucu yeniden hesaplanmamalıdır). |
IsMapped { get; set; } | Bu alanın eşlenmiş bir alan olup olmadığını alır veya ayarlar. |
IsVerticalFormatting { get; set; } | Dikey biçimlendirme için karakter dönüştürmenin etkinleştirilip etkinleştirilmeyeceğini alır veya ayarlar. |
LocaleId { get; set; } | Alanın LCID’sini alır veya ayarlar. |
Result { get; set; } | Alan ayırıcı ile alan sonu arasındaki metni alır veya ayarlar. |
Separator { get; } | Alan ayırıcıyı temsil eden düğümü alır. Olabilirhükümsüz . |
Start { get; } | Alanın başlangıcını temsil eden düğümü alır. |
TextAfter { get; set; } | Alan boş değilse alandan sonra eklenecek metni alır veya ayarlar. |
TextBefore { get; set; } | Alan boş değilse alandan önce eklenecek metni alır veya ayarlar. |
override Type { get; } | Microsoft Word alan türünü alır. |
yöntemler
İsim | Tanım |
---|---|
GetFieldCode() | Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. Alt alanların hem alan kodu hem de alan sonucu dahil edilir. |
GetFieldCode(bool) | Alan başlangıcı ile alan ayırıcı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. |
Remove() | Alanı belgeden kaldırır. Alanın hemen ardından bir düğüm döndürür. Alanın sonu, üst düğümünün son child ‘si ise, üst paragrafını döndürür. Alan zaten kaldırılmışsa şunu döndürür:hükümsüz . |
Unlink() | Alanın bağlantısını kaldırır. |
Update() | Alan güncellemesini gerçekleştirir. Alan zaten güncelleniyorsa atar. |
Update(bool) | Bir alan güncellemesi gerçekleştirir. Alan zaten güncelleniyorsa atar. |
Notlar
Adres-mektup birleştirme ana belgesindeki birleştirme karakterleri içindeki bir veri alanının adını alır. Ana belge seçilen veri kaynağıyla birleştirildiğinde, birleştirme alanının yerine belirtilen veri alanındaki bilgiler eklenir.
Örnekler
Adres-mektup birleştirme gerçekleştirmek için MERGEFIELD alanlarının nasıl kullanılacağını gösterir.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Adres-mektup birleştirme veri kaynağı olarak kullanılacak bir veri tablosu oluşturun.
DataTable table = new DataTable("Employees");
table.Columns.Add("Courtesy Title");
table.Columns.Add("First Name");
table.Columns.Add("Last Name");
table.Rows.Add("Mr.", "John", "Doe");
table.Rows.Add("Mrs.", "Jane", "Cardholder");
// Veri kaynağındaki bir sütunun adına ayarlanmış FieldName özelliğine sahip bir MERGEFIELD ekleyin.
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Courtesy Title";
fieldMergeField.IsMapped = true;
fieldMergeField.IsVerticalFormatting = false;
// Birleştirme gerçekleştiğinde bu alanın kabul ettiği değerin önüne ve arkasına metin uygulayabiliriz.
fieldMergeField.TextBefore = "Dear ";
fieldMergeField.TextAfter = " ";
Assert.AreEqual(" MERGEFIELD \"Courtesy Title\" \\m \\b \"Dear \" \\f \" \"", fieldMergeField.GetFieldCode());
// Veri kaynağındaki farklı bir sütun için başka bir MERGEFIELD ekleyin.
fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Last Name";
fieldMergeField.TextAfter = ":";
doc.UpdateFields();
doc.MailMerge.Execute(table);
Assert.AreEqual("Dear Mr. Doe:\u000cDear Mrs. Cardholder:", doc.GetText().Trim());
Ayrıca bakınız
- class Field
- ad alanı Aspose.Words.Fields
- toplantı Aspose.Words