Range

Range class

يمثل منطقة مجاورة في مستند.

public class Range

الخصائص

اسم وصف
Bookmarks { get; } إرجاع أBookmarks المجموعة التي تمثل جميع الإشارات المرجعية في النطاق.
Fields { get; } إرجاع أFields المجموعة التي تمثل جميع الحقول في النطاق.
FormFields { get; } إرجاع أFormFields المجموعة التي تمثل جميع حقول النموذج في النطاق.
StructuredDocumentTags { get; } إرجاع أStructuredDocumentTags المجموعة التي تمثل جميع علامات المستند المهيكلة في النطاق.
Text { get; } يحصل على نص النطاق .

طُرق

اسم وصف
Delete() حذف كافة أحرف النطاق .
NormalizeFieldTypes() يغير قيم نوع الحقلFieldType منFieldStart وFieldSeparator وFieldEnd في هذا النطاق بحيث تتوافق مع أنواع الحقول الموجودة في أكواد الحقول.
Replace(Regex, string) يستبدل كل تكرارات نمط الحرف المحدد بواسطة تعبير عادي بسلسلة أخرى.
Replace(string, string) يستبدل كل تكرارات نمط سلسلة الأحرف المحددة بسلسلة بديلة.
Replace(Regex, string, FindReplaceOptions) يستبدل كل تكرارات نمط الحرف المحدد بواسطة تعبير عادي بسلسلة أخرى.
Replace(string, string, FindReplaceOptions) يستبدل كل تكرارات نمط سلسلة الأحرف المحددة بسلسلة بديلة.
ToDocument() إنشاء مستند جديد كامل التكوين يحتوي على النطاق.
UnlinkFields() إلغاء ربط الحقول في هذا النطاق .
UpdateFields() يقوم بتحديث قيم حقول الوثيقة في هذا النطاق.

ملاحظات

يتم تمثيل المستند بشجرة من العقد وتوفر العقد Operations للعمل مع الشجرة ، ولكن بعض العمليات يكون من الأسهل تنفيذها إذا تم التعامل مع document كتسلسل نص متجاور.

نطاق هي واجهة “واجهة” توفر طرقًا تتعامل مع document أو أجزاء من المستند كنص “مسطح” بغض النظر عن حقيقة أن عُقد document يتم تخزينها في نموذج كائن يشبه الشجرة.

نطاق لا يحتوي على أي نص أو عقد ، فهو مجرد عرض أو “نافذة” فوق جزء من المستند.

أمثلة

يوضح كيفية الحصول على محتويات النص لجميع العقد التي يغطيها النطاق.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Hello world!");

Assert.AreEqual("Hello world!", doc.Range.Text.Trim());

أنظر أيضا