FieldMergeField
محتويات
[
يخفي
]FieldMergeField class
ينفذ حقل MERGEFIELD.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldMergeField : Field
الخصائص
| اسم | وصف |
|---|---|
| DisplayResult { get; } | الحصول على النص الذي يمثل نتيجة الحقل المعروض. |
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
| FieldName { get; set; } | الحصول على اسم حقل البيانات أو تعيينه. |
| FieldNameNoPrefix { get; } | يقوم بإرجاع اسم حقل البيانات فقط. يتم تجريد أي بادئة من خاصية البادئة. |
| Format { get; } | يحصل علىFieldFormat الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
| IsDirty { get; set; } | الحصول على أو تعيين ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب تعديلات أخرى تم إجراؤها على المستند. |
| IsLocked { get; set; } | الحصول على أو تعيين ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب النتيجة). |
| IsMapped { get; set; } | الحصول على أو تعيين ما إذا كان هذا الحقل حقلاً معينًا. |
| IsVerticalFormatting { get; set; } | الحصول على أو تعيين ما إذا كان سيتم تمكين تحويل الأحرف للتنسيق العمودي. |
| LocaleId { get; set; } | الحصول على أو تعيين LCID الخاص بالحقل. |
| Result { get; set; } | الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل. |
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقول. يمكن ان يكونباطل . |
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
| TextAfter { get; set; } | الحصول على النص الذي سيتم إدراجه بعد الحقل أو تعيينه إذا لم يكن الحقل فارغًا. |
| TextBefore { get; set; } | الحصول على النص الذي سيتم إدراجه قبل الحقل أو تعيينه إذا لم يكن الحقل فارغًا. |
| override Type { get; } | الحصول على نوع حقل Microsoft Word. |
طُرق
| اسم | وصف |
|---|---|
| GetFieldCode() | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
| Remove() | إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعهباطل . |
| Unlink() | يقوم بإلغاء ربط الحقل. |
| Update() | يقوم بإجراء التحديث الميداني. يتم الرمي إذا تم تحديث الحقل بالفعل. |
| Update(bool) | إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل. |
ملاحظات
استرداد اسم حقل البيانات ضمن أحرف الدمج في مستند رئيسي لدمج المراسلات. عند دمج المستند الرئيسي مع مصدر البيانات المحدد، يتم إدراج المعلومات من حقل البيانات المحدد بدلاً من حقل الدمج.
أمثلة
يوضح كيفية استخدام حقول MERGEFIELD لإجراء عملية دمج البريد.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// قم بإنشاء جدول بيانات لاستخدامه كمصدر بيانات لدمج المراسلات.
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");
// قم بإدراج MERGEFIELD مع تعيين خاصية FieldName على اسم عمود في مصدر البيانات.
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Courtesy Title";
fieldMergeField.IsMapped = true;
fieldMergeField.IsVerticalFormatting = false;
// يمكننا تطبيق النص قبل وبعد القيمة التي يقبلها هذا الحقل عند حدوث الدمج.
fieldMergeField.TextBefore = "Dear ";
fieldMergeField.TextAfter = " ";
Assert.AreEqual(" MERGEFIELD \"Courtesy Title\" \\m \\b \"Dear \" \\f \" \"", fieldMergeField.GetFieldCode());
// أدخل MERGEFIELD آخر لعمود مختلف في مصدر البيانات.
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());
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
