Range

Range class

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

لمعرفة المزيد، قم بزيارةالعمل مع النطاقات مقالة توثيقية.

public class Range : IEnumerable<Node>

الخصائص

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

طُرق

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

ملاحظات

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

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

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

أمثلة

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

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

builder.Write("Hello world!");

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

أنظر أيضا