עבודה עם קבוצות דפים
עבודה עם קבוצות דפים
מדריך זה מראה כיצד לתאר תת-קבוצה של דפי מסמך – בחירה שרירותית של אינדקסי דפים, במקום טווח רציף יחיד – באמצעות 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() |
