Framesets
Framesets
این راهنما نشان می‌دهد چگونه ساختار صفحهٔ فریم‌های قدیمی را در Aspose.Words FOSS برای .NET با استفاده از کلاس‌های Frameset و FramesetCollection بخوانیم، که یک صفحهٔ فریم و فریم‌های فرزند آن را زمانی که ساختار سند مجموعه‌ای از فریم‌ها را مدل می‌کند، نشان می‌دهند.
کلاس فریم‌ست
Frameset نمایانگر یک صفحهٔ فریم یا یک فریم منفرد در یک صفحهٔ فریم است. Document.Frameset ریشهٔ Frameset را برای سندی که از ساختار HTML فریم‌دار بارگذاری شده است، بازمی‌گرداند. FrameDefaultUrl (رشته) URL صفحه وب یا نام فایل سندی است که در آن فریم نمایش داده می‌شود. IsFrameLinkToFile (بولی) نشان می‌دهد آیا مقدار 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.ChildFramesets (یک FramesetCollection) با GetEnumerator() / foreach، به‌صورت بازگشتی به هر فرزندی که خود دارای ChildFramesets بیشتر باشد.
چگونه می‌توانم تعداد فریم‌های فرزند یک فریم‌ست را بدانم؟
مقدار FramesetCollection.Count را در ویژگی ChildFramesets آن بخوانید.
«IsFrameLinkToFile» چه چیزی به شما می‌گوید؟
اینکه آیا صفحه وب یا نام فایل سند در FrameDefaultUrl منبع خارجی است که فریم به آن لینک دارد یا خیر.
خلاصه API Reference
| کلاس/متد | توضیح |
|---|---|
Document.Frameset | ریشه Frameset برای سندی که از منبع HTML مبتنی بر فریم‌ها بارگذاری شده است |
Frameset | نمایش‌دهنده یک صفحه فریم یا یک فریم منفرد در یک صفحه فریم |
Frameset.FrameDefaultUrl | آدرس وب‌صفحه یا نام فایل سندی که در فریم نمایش داده می‌شود |
Frameset.IsFrameLinkToFile | آیا FrameDefaultUrl یک منبع لینک‌خورده خارجی است |
Frameset.ChildFramesets | FramesetCollection از فریم‌های فرزند و صفحات فریم‌ها |
FramesetCollection | مجموعه‌ای از نمونه‌های Frameset; Count, GetEnumerator |
