Framesets
Framesets
מדריך זה מראה כיצד לקרוא מבנה דף-מסגרות מיושן ב-Aspose.Words FOSS עבור .NET באמצעות המחלקות Frameset ו-FramesetCollection, המייצגות דף מסגרות ואת המסגרות הילדיות שלו כאשר מבנה המסמך מודל של קבוצת מסגרות.
מחלקת Frameset
Frameset מייצג דף מסגרות או מסגרת יחידה בדף מסגרות. Document.Frameset מחזיר את ה-Frameset השורש עבור מסמך שנטען ממבנה HTML ממוסגר. FrameDefaultUrl (string) הוא כתובת ה-URL של דף האינטרנט או שם קובץ המסמך המוצג באותה מסגרת. IsFrameLinkToFile (bool) מציין האם ערך ה-FrameDefaultUrl הוא משאב חיצוני שהמסגרת מקשרת אליו. ChildFramesets מחזיר FramesetCollection של המסגרות הילדיות ודפי המסגרות המקוננים תחת זו.
איטרציה על מסגרות ילדה עם FramesetCollection
FramesetCollection מיישם את IEnumerable<Frameset>, ולכן GetEnumerator() תומך באיטרציה foreach על המסגרות שהוא מכיל. Count מדווח על מספר המסגרות או דפי המסגרות באוסף. ניתן לשלב את Count והאיטרציה עם ChildFramesets כדי לעבור בצורה רקורסיבית על מבנה דף-מסגרות מקונן — כל Frameset ילדי יכול להכיל בעצמו ChildFramesets נוספים.
טיפים ושיטות עבודה מומלצות
- בדוק את
Document.Framesetעבורnullלפני קריאת המאפיינים שלו — רוב המסמכים אינם דפי מסגרות, ולכן מאפיין זה מתמלא רק כאשר HTML המקור השתמש בפריסת מסגרות. - עבור על
ChildFramesetsבאופן רקורסיבי (במקום להניח מבנה שטוח ברמת-אחד) מכיוון שדף מסגרות יכול לקנן דפי מסגרות נוספים בתוך המסגרות שלו. - השתמש ב-
IsFrameLinkToFileכדי להבדיל בין מסגרת שמקשרת למשאב חיצוני לבין כזו שמשלבת שם קובץ מסמך ישירות ב-FrameDefaultUrl. FramesetCollection.Countהיא דרך זולה לבדוק אם ל-Framesetיש ילדים לפני האיטרציה.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
Document.Frameset הוא null | המסמך לא נטען ממקור HTML מבוסס על מסגרות | אשר שהמסמך המקור השתמש בפועל במסגרות HTML לפני הסתמכות על תכונה זו |
חזרה על ChildFramesets מפספסת מסגרות מקוננות | רק הרמה העליונה חולפה | הקרא רקורסיבית לכל צאצא Frameset.ChildFramesets במקום לבצע איטרציה ברמה אחת בלבד |
| לא ניתן לקבוע אם מסגרת מצביעה על קובץ או על כתובת URL | IsFrameLinkToFile לא נבדק | קרא את IsFrameLinkToFile לצד FrameDefaultUrl כדי לדעת כיצד לפתור את היעד |
FAQ
מהו Frameset ב-Aspose.Words FOSS עבור .NET?
זה מייצג דף מסגרות או מסגרת בודדת בדף מסגרות, מוצג כ-Document.Frameset למסמכים שנטענים ממקור HTML מבוסס מסגרות.
איך אני מציג את כל המסגרות ב-frameset?
חזור על Frameset.ChildFramesets (a FramesetCollection) עם GetEnumerator() / foreach, תוך חזרה רקורסיבית לכל ילד שיש לו ChildFramesets נוספים.
איך אני יודע כמה מסגרות-ילד יש ל-Frameset?
קרא את FramesetCollection.Count בתכונה ChildFramesets שלו.
מה IsFrameLinkToFile אומר לך?
האם דף האינטרנט או שם קובץ המסמך ב-FrameDefaultUrl הוא משאב חיצוני שהפריים מקושר אליו.
API Reference סיכום
| מחלקה/מתודה | תיאור |
|---|---|
Document.Frameset | שורש Frameset עבור מסמך שהוטען ממקור HTML מבוסס מסגרות |
Frameset | מייצג דף מסגרות או מסגרת יחידה בדף מסגרות |
Frameset.FrameDefaultUrl | כתובת URL של דף אינטרנט או שם קובץ המסמך המוצגים במסגרת |
Frameset.IsFrameLinkToFile | האם FrameDefaultUrl הוא משאב מקושר חיצוני |
Frameset.ChildFramesets | FramesetCollection של מסגרות ילדים ודפי מסגרות |
FramesetCollection | אוסף של מופעי Frameset; Count, GetEnumerator |
