FieldIncludeText

FieldIncludeText class

تنفيذ حقل INCLUDETEXT .

public class FieldIncludeText : Field

المنشئون

اسم وصف
FieldIncludeText() Default_Constructor

الخصائص

اسم وصف
BookmarkName { get; set; } الحصول على أو تحديد اسم الإشارة المرجعية في المستند المراد تضمينه .
DisplayResult { get; } يحصل على النص الذي يمثل نتيجة الحقل المعروض.
Encoding { get; set; } الحصول على أو تعيين الترميز المطبق على البيانات داخل الملف المرجعي.
End { get; } يحصل على العقدة التي تمثل نهاية الحقل.
Format { get; } يحصل على أFieldFormat كائن يوفر وصولاً مكتوبًا إلى تنسيق الحقل.
IsDirty { get; set; } الحصول على أو تحديد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند.
IsLocked { get; set; } تحديد ما إذا كان الحقل مغلقًا أم لا (يجب عدم إعادة حساب النتيجة).
LocaleId { get; set; } الحصول على أو تحديد LCID للحقل.
LockFields { get; set; } يحصل أو يحدد ما إذا كان سيتم منع تحديث الحقول في المستند المضمن.
MimeType { get; set; } الحصول على أو تعيين نوع MIME للملف المشار إليه.
NamespaceMappings { get; set; } الحصول على أو تعيين تعيينات مساحة الاسم لاستعلامات XPath.
Result { get; set; } الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل.
Separator { get; } يحصل على العقدة التي تمثل فاصل المجال. يمكن أن يكون فارغًا.
SourceFullName { get; set; } الحصول على أو تحديد موقع المستند باستخدام IRI .
Start { get; } يحصل على العقدة التي تمثل بداية الحقل.
TextConverter { get; set; } الحصول على أو تحديد اسم محول النص لتنسيق الملف المضمن.
virtual Type { get; } يحصل على نوع حقل Microsoft Word .
XPath { get; set; } الحصول على XPath أو تعيينه للجزء المطلوب من ملف XML.
XslTransformation { get; set; } الحصول على أو تعيين موقع تحويل XSL لتنسيق بيانات XML.

طُرق

اسم وصف
GetFieldCode() إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل) . يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool) إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل) .
Remove() يزيل الحقل من المستند. إرجاع عقدة بعد الحقل مباشرة. إذا كانت نهاية الحقل هي آخر child من العقدة الأصلية ، يتم إرجاع فقرته الأصلية. إذا تمت إزالة الحقل بالفعل ، يعود لا شيء .
Unlink() يقوم بإلغاء ربط الحقل.
Update() يقوم بالتحديث الميداني. يرمي إذا تم تحديث الحقل بالفعل.
Update(bool) يقوم بإجراء تحديث ميداني. يرمي إذا تم تحديث الحقل بالفعل.

ملاحظات

إدراج كل أو جزء من النص والرسومات المضمنة في مستند آخر.

أمثلة

يوضح كيفية إنشاء حقل INCLUDETEXT وتعيين خصائصه.

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

    // فيما يلي طريقتان لاستخدام حقول INCLUDETEXT لعرض محتويات ملف XML في نظام الملفات المحلي.
    // 1 - إجراء تحويل XSL على مستند XML:
    FieldIncludeText fieldIncludeText = CreateFieldIncludeText(builder, MyDir + "CD collection data.xml", false, "text/xml", "XML", "ISO-8859-1");
    fieldIncludeText.XslTransformation = MyDir + "CD collection XSL transformation.xsl";

    builder.Writeln();

    // 2 - استخدم XPath لأخذ عناصر محددة من مستند XML:
    fieldIncludeText = CreateFieldIncludeText(builder, MyDir + "CD collection data.xml", false, "text/xml", "XML", "ISO-8859-1");
    fieldIncludeText.NamespaceMappings = "xmlns:n='myNamespace'";
    fieldIncludeText.XPath = "/catalog/cd/title";

    doc.Save(ArtifactsDir + "Field.INCLUDETEXT.docx");

/// <summary>
/// استخدم أداة إنشاء المستندات لإدراج حقل INCLUDETEXT بخصائص مخصصة.
/// </summary>
public FieldIncludeText CreateFieldIncludeText(DocumentBuilder builder, string sourceFullName, bool lockFields, string mimeType, string textConverter, string encoding)
{
    FieldIncludeText fieldIncludeText = (FieldIncludeText)builder.InsertField(FieldType.FieldIncludeText, true);
    fieldIncludeText.SourceFullName = sourceFullName;
    fieldIncludeText.LockFields = lockFields;
    fieldIncludeText.MimeType = mimeType;
    fieldIncludeText.TextConverter = textConverter;
    fieldIncludeText.Encoding = encoding;

    return fieldIncludeText;
}

أنظر أيضا