العمل مع مجموعات الصفحات
العمل مع مجموعات الصفحات
يوضح هذا الدليل كيفية وصف مجموعة فرعية من صفحات المستند – اختيار عشوائي لمؤشرات الصفحات، بدلاً من نطاق متواصل واحد – باستخدام PageSet in Aspose.Words FOSS لـ .NET. PageSet هي فئة مغلقة في الـ Aspose.Words.Saving النطاق الذي يصف مجموعة عشوائية من الصفحات.
إنشاء PageSet
PageSet لديها ثلاثة منشئات: PageSet(page) يبني مجموعة من صفحة واحدة من مؤشر صفحة واحد؛ PageSet(pages) يبني مجموعة من مجموعة من مؤشرات الصفحات الدقيقة؛ وPageSet(ranges) يبني مجموعة من مجموعة من نطاقات الصفحات. اختر المنشئ الذي يتطابق مع طريقة تعبير اختيار الصفحات في حالتك — صفحة واحدة، قائمة متفرقة من الصفحات، أو نطاقات متصلة.
المجموعات المدمجة: الكل، الزوجية، والفردية
توفر ثلاث خصائص ثابتة مجموعات جاهزة دون الحاجة إلى إنشائها يدويًا: PageSet.All تُعيد مجموعة تحتوي على كل صفحة من المستند بترتيبها الأصلي، PageSet.Even تُعيد مجموعة تحتوي فقط على الصفحات ذات الأرقام الزوجية، وPageSet.Odd تُعيد مجموعة تحتوي فقط على الصفحات ذات الأرقام الفردية.
تعداد مجموعة الصفحات
PageSet يطبق IEnumerable<int>، لذا أي مثال PageSet – سواء تم إنشاؤه مباشرة أو تم الحصول عليه من All، Even أو Odd – يمكن تكراره باستخدام GetEnumerator() (أو حلقة foreach) لاستعراض مؤشرات الصفحات التي يحتويها.
نصائح وأفضل الممارسات
- استخدم
PageSet.AllأوEvenأوOddللحالات الشائعة بدلاً من إنشاء قائمة مؤشرات صريحة، ما لم تطابق الاختيارات أحد تلك الأنماط الثلاثة. - اختر مُنشئ
PageSet(pages)لاختيار صفحات مشتتة وغير متجاورة، واستخدمPageSet(ranges)عندما يُعبّر الاختيار بصورة طبيعية ككتلة واحدة أو أكثر متجاورة. - نظرًا لأن
PageSetيطبقIEnumerable<int>، يمكن استهلاكه في أي مكان يُتوقع فيهIEnumerable<int>من مؤشرات الصفحات، دون أي خطوة تحويل إضافية.
مشكلات شائعة
| المشكلة | السبب | الإصلاح |
|---|---|---|
يظهر PageSet المبني من PageSet.Even أو Odd فارغًا عند تعدده في مستند قصير | المستند يحتوي على عدد أقل من الصفحات الزوجية (أو الفردية) مما هو متوقع | تأكد من عدد صفحات المستند الفعلي قبل الاعتماد على Even/Odd |
| غير متأكد أي مُنشئ يجب استخدامه لمزيج من الصفحات الفردية والنطاقات | PageSet(pages) و PageSet(ranges) كل منهما يقبل شكلًا واحدًا فقط من الإدخال | أنشئ نسخًا منفصلة من PageSet للمؤشرات والنطاقات، أو قم بتوحيد الاختيار إلى شكل واحد قبل إنشائه |
FAQ
كيف أحصل على PageSet يحتوي على كل صفحة من مستند؟
استخدم الخاصية الثابتة PageSet.All.
كيف يمكنني اختيار الصفحات الزوجية أو الفردية فقط؟
استخدم PageSet.Even أو PageSet.Odd.
كيف يمكنني إنشاء PageSet من قائمة عشوائية لأرقام الصفحات؟
استخدم مُنشئ PageSet(pages) مع مجموعة من مؤشرات الصفحات الدقيقة.
هل يمكنني التكرار على الصفحات التي يحتويها PageSet؟
نعم – PageSet ينفّذ IEnumerable<int>، لذا GetEnumerator() أو حلقة foreach تتنقل عبر مؤشرات الصفحات التي يصفها.
API Reference ملخص
| الفئة | وصف |
|---|---|
PageSet | يصف مجموعة من الصفحات؛ مُنشئات لصفحة واحدة، مؤشرات دقيقة، أو نطاقات؛ All, Even, Odd, GetEnumerator() |
