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() | إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعهباطل . |
| 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.UpdateFields();
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;
}
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
