Mengimpor Node dengan NodeImporter

Mengimpor Node dengan NodeImporter

Panduan ini menunjukkan cara memindahkan konten antara dua berbeda Document instansi di Aspose.Words FOSS untuk .NET menggunakan yang didedikasikan NodeImporter kelas dan terperinci ImportFormatOptions, untuk skenario di mana Anda perlu mengimpor banyak node secara efisien atau mengendalikan perilaku impor di luar yang dasar ImportFormatMode pilihan. Untuk yang lebih sederhana Document.ImportNode, Document.AppendDocument, dan DocumentBuilder.InsertDocument metode kemudahan, lihat Bekerja dengan Dokumen panduan.

NodeImporter: Impor Berulang Tanpa Penyiapan Berulang

NodeImporter dibangun untuk impor berulang node dari satu dokumen ke dokumen lain, menghindari biaya penyiapan per panggilan pada impor satu kali pakai. Buat satu dengan new NodeImporter(srcDoc, dstDoc, importFormatMode) — atau overload new NodeImporter(srcDoc, dstDoc, importFormatMode, importFormatOptions) untuk kontrol lebih halus — sekali, lalu panggil ImportNode(srcNode, isImportChildren) pada instance yang sama untuk setiap node yang perlu Anda bawa. Menggunakan kembali satu instance NodeImporter pada banyak panggilan menghindari biaya penyiapan yang ditimbulkan oleh impor kemudahan per panggilan setiap kali.

Kontrol Impor Terperinci dengan ImportFormatOptions

ImportFormatOptions melengkapi pilihan ImportFormatMode dasar (UseDestinationStyles, KeepSourceFormatting, KeepDifferentStyles) dengan saklar yang lebih halus: SmartStyleBehavior (bool) mengontrol bagaimana gaya dengan nama yang sama di sumber dan tujuan diimpor. KeepSourceNumbering (bool) mengontrol bagaimana penomoran diimpor ketika terjadi benturan antara sumber dan tujuan. IgnoreTextBoxes dan IgnoreHeaderFooter (bool) menekan pemformatan sumber untuk konten kotak teks serta header/footer secara khusus ketika KeepSourceFormatting berlaku. MergePastedLists (bool) menggabungkan daftar yang ditempel dengan daftar di sekitarnya alih-alih mempertahankannya terpisah. ForceCopyStyles (bool) menyalin gaya yang konflik alih-alih menggunakan kembali versi tujuan, dalam mode KeepSourceFormatting. AdjustSentenceAndWordSpacing (bool) secara otomatis menyesuaikan spasi. AppendDocumentWithNewPage (bool) memaksa tipe bagian pertama yang diimpor menjadi NewPage.

Tips dan Praktik Terbaik

• Buat satu instance NodeImporter dan gunakan kembali di seluruh loop panggilan ImportNode saat mengimpor banyak node — membuat importer baru per node mengulangi pekerjaan penyiapan yang tidak perlu.
• Berikan instance ImportFormatOptions ke overload konstruktor NodeImporter ketika pilihan ImportFormatMode biasa tidak cukup tepat — misalnya, untuk mempertahankan penomoran daftar sumber dengan KeepSourceNumbering sambil tetap menggunakan KeepSourceFormatting secara keseluruhan.
• Atur IgnoreTextBoxes atau IgnoreHeaderFooter ketika KeepSourceFormatting mengambil lebih banyak gaya sumber daripada yang Anda inginkan untuk tipe konten tersebut saja.
• NodeImporter.ImportNode(srcNode, isImportChildren) mencerminkan panggilan impor tingkat dokumen dalam tanda tangan dan perilaku; perbedaannya terletak pada efisiensi penggunaan kembali, bukan semantik impor.

Masalah Umum

FAQ

Kapan saya harus menggunakan NodeImporter alih-alih panggilan impor tunggal?

Saat mengimpor banyak node dalam sebuah loop — buat satu NodeImporter di awal dan panggil ImportNode berulang kali, daripada membayar biaya penyiapan pada setiap panggilan.

Apa yang ImportFormatOptions tambahkan di luar ImportFormatMode?

Sakelar yang lebih halus seperti SmartStyleBehavior, KeepSourceNumbering, IgnoreTextBoxes, IgnoreHeaderFooter, MergePastedLists, ForceCopyStyles, AdjustSentenceAndWordSpacing, dan AppendDocumentWithNewPage, ditumpuk di atas pilihan dasar ImportFormatMode.

Apakah NodeImporter.ImportNode berperilaku berbeda dibandingkan mengimpor pada tingkat dokumen?

Tidak — keduanya menerima node sumber dan flag isImportChildren lalu mengimpornya ke dalam dokumen tujuan; NodeImporter ada agar penyiapan dilakukan sekali dan dapat digunakan kembali pada banyak pemanggilan.

Bagaimana cara saya menjaga penomoran daftar pada dokumen sumber tetap utuh saat mengimpor?

Bangun NodeImporter dengan ImportFormatOptions di mana KeepSourceNumbering adalah true.

API Reference Ringkasan

Lihat Juga

• Aspose.Words for .NET — Enterprise Documentation