Framesets

Panduan ini menunjukkan cara membaca struktur halaman frame warisan di Aspose.Words FOSS untuk .NET menggunakan kelas Frameset dan FramesetCollection, yang mewakili halaman frame dan frame anaknya ketika struktur dokumen memodelkan sekumpulan frame.

Kelas Frameset

Frameset mewakili halaman frame atau satu frame pada halaman frame. Document.Frameset mengembalikan Frameset akar untuk dokumen yang dimuat dari struktur HTML berframe. FrameDefaultUrl (string) adalah URL halaman web atau nama file dokumen yang ditampilkan dalam frame tersebut. IsFrameLinkToFile (bool) menunjukkan apakah nilai FrameDefaultUrl adalah sumber eksternal yang ditautkan oleh frame. ChildFramesets mengembalikan FramesetCollection dari frame anak dan halaman frame yang bersarang di bawah ini.

Iterasi Frame Anak dengan FramesetCollection

FramesetCollection mengimplementasikan IEnumerable<Frameset>, sehingga GetEnumerator() mendukung iterasi foreach atas frame yang dikandungnya. Count melaporkan jumlah frame atau halaman frame dalam koleksi. Gabungkan Count dan iterasi dengan ChildFramesets untuk menelusuri struktur halaman frame bersarang secara rekursif — setiap Frameset anak dapat sendiri menampung ChildFramesets lebih lanjut.

Tips dan Praktik Terbaik

Periksa Document.Frameset untuk null sebelum membaca propertinya — sebagian besar dokumen bukan halaman frames, sehingga properti ini hanya terisi ketika sumber HTML menggunakan tata letak frames.
Jelajahi ChildFramesets secara rekursif (alih-alih mengasumsikan struktur datar satu tingkat) karena halaman frames dapat menumpuk halaman frames lain di dalam frames-nya.
Gunakan IsFrameLinkToFile untuk membedakan frame yang menautkan ke sumber eksternal dengan yang menyematkan nama file dokumen secara langsung di FrameDefaultUrl.
FramesetCollection.Count adalah cara mudah untuk memeriksa apakah Frameset memiliki anak sebelum iterasi.

Masalah Umum

Masalah	Penyebab	Perbaikan
`Document.Frameset` adalah `null`	Dokumen tidak dimuat dari sumber HTML berbasis frame	Pastikan dokumen sumber memang menggunakan frame HTML sebelum mengandalkan properti ini
Iterasi `ChildFramesets` melewatkan frame bersarang	Hanya level teratas yang diiterasi	Lakukan rekursi ke setiap anak `Frameset.ChildFramesets` alih-alih mengiterasi satu tingkat ke dalam
Tidak dapat menentukan apakah sebuah frame mengarah ke file atau URL	`IsFrameLinkToFile` tidak diperiksa	Baca `IsFrameLinkToFile` bersama `FrameDefaultUrl` untuk mengetahui cara menyelesaikan target

FAQ

Apa itu Frameset dalam Aspose.Words FOSS untuk .NET?

Ini mewakili halaman frames atau satu frame pada halaman frames, yang diekspos sebagai Document.Frameset untuk dokumen yang dimuat dari sumber HTML berbasis frames.

Bagaimana cara saya menampilkan semua frame dalam sebuah frameset?

Iterasi Frameset.ChildFramesets (sebuah FramesetCollection) dengan GetEnumerator() / foreach, melakukan rekursi ke setiap anak yang memiliki ChildFramesets lebih lanjut.

Bagaimana saya tahu berapa banyak frame anak yang dimiliki sebuah Frameset?

Baca FramesetCollection.Count pada properti ChildFramesets nya.

Apa yang IsFrameLinkToFile beri tahu Anda?

Apakah halaman web atau nama file dokumen dalam FrameDefaultUrl merupakan sumber eksternal yang ditautkan oleh frame.

API Reference Ringkasan

Kelas/Metode	Deskripsi
`Document.Frameset`	Root `Frameset` untuk dokumen yang dimuat dari sumber HTML berbasis frame
`Frameset`	Mewakili halaman frames atau satu frame pada halaman frames
`Frameset.FrameDefaultUrl`	URL halaman web atau nama file dokumen yang ditampilkan dalam bingkai
`Frameset.IsFrameLinkToFile`	Apakah `FrameDefaultUrl` adalah sumber daya yang ditautkan secara eksternal
`Frameset.ChildFramesets`	`FramesetCollection` dari frame anak dan halaman frame
`FramesetCollection`	Koleksi `Frameset` instance; `Count`, `GetEnumerator`

Lihat Juga

Aspose.Words for .NET — Enterprise Documentation