Cara Menggunakan Aspose.Words untuk .NET melalui COM Interop

Informasi dalam topik ini berlaku untuk skenario ketika Anda ingin menggunakan Aspose.Words untuk .NET melalui COM Interop dalam salah satu bahasa pemrograman berikut:

  • ASP
  • Delphi (Contoh)
  • JScript
  • Perl
  • PHP
  • Pembangun Kekuatan
  • Python
  • VBScript
  • Visual Basic

Bekerja dengan COM Interop

Aspose.Words untuk .NET dijalankan di bawah kendali .NET Framework dan ini disebut kode terkelola. Kode yang ditulis dalam semua bahasa di atas berjalan di luar .NET Framework dan disebut kode tidak terkelola. Interaksi antara kode yang tidak dikelola dan Aspose.Words terjadi melalui fasilitas .NET yang disebut COM Interop.

Objek Aspose.Words adalah objek .NET, tetapi ketika digunakan melalui COM Interop, objek tersebut muncul sebagai objek COM dalam bahasa pemrograman Anda. Oleh karena itu, yang terbaik adalah memastikan Anda mengetahui cara membuat dan menggunakan objek COM dalam bahasa pemrograman Anda, sebelum Anda mulai menggunakan Aspose.Words.

Berikut adalah topik-topik yang pada akhirnya perlu Anda kuasai:

Daftarkan Aspose.Words untuk .NET dengan COM Interop

Setelah Instalasi, Anda perlu mendaftarkan Aspose.Words untuk COM Interop menggunakan utilitas regasm.exe.

regasm.exe adalah alat yang disertakan dalam .NET Framework SDK. Semua alat SDK .NET Framework terletak di direktori %windir%\Microsoft .NET\Framework\<FrameworkVersion>\, misalnya C:\Windows\Microsoft .NET\Framework\v4.0.30319.

Untuk mendapatkan file tlb, jalankan C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe <installdir>\lib\net40-client\Aspose.Words.dll /tlb /codebase dalam cmd, di mana <installdir> adalah direktori tempat Anda menginstal Aspose.Words, biasanya %USERPROFILE%\.nuget\packages\aspose.words\.

Bekerja dengan Aspose.Words melalui COM Interop

ProgIDs

ProgID adalah singkatan dari “programmatic identifier”, ini adalah nama kelas COM yang perlu Anda gunakan untuk membuat objek.

Saat ini, Aspose.Words mendefinisikan empat objek COM yang dapat dibuat secara publik. ProgIDs-nya adalah:

  • Pembantu
  • Dokumen
  • Pembuat Dokumen
  • Lisensi

ProgIDs terdiri dari nama perpustakaan (“Aspose.Words”) dan nama kelas.

Ketik Perpustakaan

Selama instalasi, Aspose.Words.tlb (perpustakaan tipe COM) disalin ke komputer Anda ke:

  • Untuk .NET Framework 4.0 hingga \lib\net40-client

Jika bahasa pemrograman Anda (misalnya Visual Basic atau Delphi) memungkinkan Anda untuk mereferensikan pustaka tipe COM, tambahkan referensi ke Aspose.Words.tlb dan Anda akan dapat melihat semua kelas, metode, properti, dan enumerasi Aspose.Words di Peramban Objek Anda.

Membuat Objek COM

Pembuatan objek .NET mirip dengan pembuatan objek COM normal:

VBScript

Penolong redup
Setel pembantu = CreateObject("Aspose.Words.ComHelper")
 

Setelah dibuat, Anda dapat mengakses metode dan properti objek, seolah-olah itu adalah objek COM:

VBScript

Redupkan dok
Setel doc = helper.Open("C:\my.doc")
 

Beberapa metode mengalami kelebihan beban dan akan diekspos oleh COM Interop dengan akhiran numerik yang ditambahkan ke dalamnya, kecuali metode pertama yang tidak berubah. Misalnya, kelebihan metode Document.Save menjadi Document.Save, Document.Save_2, Document.Save_3, dan sebagainya.

Untuk informasi selengkapnya, lihat artikel khusus bahasa lebih lanjut dalam dokumentasi ini.

Membuat Rakitan Pembungkus

Jika Anda perlu menggunakan banyak kelas, metode, dan properti Aspose.Words, pertimbangkan untuk membuat rakitan pembungkus (menggunakan C# atau bahasa pemrograman .NET lainnya), yang akan membantu menghindari penggunaan Aspose.Words langsung dari kode yang tidak dikelola.

Pendekatan yang baik adalah dengan mengembangkan rakitan .NET yang mereferensikan Aspose.Words dan melakukan semua pekerjaan dengannya, dan hanya memaparkan kumpulan kelas dan metode minimal ke kode yang tidak dikelola. Aplikasi Anda kemudian harus bekerja hanya dengan perpustakaan pembungkus Anda.

Mengurangi jumlah kelas dan metode yang perlu Anda panggil melalui COM Interop dapat menyederhanakan proyek Anda, karena menggunakan kelas .NET melalui COM Interop sering kali memerlukan keterampilan tingkat lanjut.