Range

Range class

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

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

public class Range

الخصائص

اسموصف
Bookmarks { get; }إرجاع أBookmarks المجموعة التي تمثل جميع الإشارات المرجعية في النطاق.
Fields { get; }إرجاع أFields المجموعة التي تمثل جميع الحقول في النطاق.
FormFields { get; }إرجاع أFormFields المجموعة التي تمثل جميع حقول النموذج في النطاق.
Revisions { get; }الحصول على مجموعة من المراجعات (التغييرات المتعقبة) الموجودة في هذا النطاق.
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()يقوم بتحديث قيم حقول المستند في هذا النطاق.

ملاحظات

يتم تمثيل المستند بواسطة شجرة من العقد وتوفر العقد عمليات للعمل مع الشجرة، ولكن يكون تنفيذ بعض العمليات أسهل إذا تم التعامل مع 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());

أنظر أيضا