GetObject dan CreateObject perilaku server otomatisasi kantor

Artikel ini membahas berbagai perilaku yang terjadi Ketika Anda menggunakan GetObject dan CreateObject fungsi dengan berbagai versi Microsoft Office aplikasi. GetObject dan CreateObject fungsi yang disediakan oleh Microsoft Visual Basic dan Microsoft Visual Basic for Applications (VBA). Namun, informasi ini juga berlaku untuk Microsoft Visual C++ jika Anda memperlakukan referensi untuk GetObject sebagai panggilan untuk GetActiveObject API, dan rujukan CreateObject sebagai panggilan untuk CoCreateInstance API.

GetObject

GetObject digunakan untuk melampirkan untuk contoh menjalankan server Otomatisasi. Ada beberapa cara yang berbeda untuk memanggil GetObject, tapi sintaks yang dianjurkan untuk Microsoft Office aplikasi adalah sebagai berikut: Jika sebuah instance dari Microsoft Excel berjalan ketika kode ini dijalankan, Anda memiliki akses ke model object contoh berjalan melalui xlApp variabel. Jika tidak ada contoh berjalan, Anda menerima berikut trappable pesan galat run-time: Jika beberapa contoh dari Microsoft Excel menjalankan, GetObject melekat pada contoh yang diluncurkan pertama. Jika Anda kemudian contoh pertama, panggilan lain untuk menutup GetObject melekat pada contoh kedua yang diluncurkan, dan begitu maju.

Anda dapat melampirkan untuk contoh khusus jika Anda tahu nama Buka dokumen dalam contoh. Sebagai contoh, jika sebuah contoh Excel berjalan dengan buku kerja terbuka yang bernama Book2, kode berikut menempel berhasil untuk contoh bahkan jika itu bukanlah contoh awal yang diluncurkan:

CreateObject

CreateObject digunakan untuk memulai contoh baru dari server Otomatisasi. Untuk contoh: Tergantung pada apakah server dirancang sebagai SingleUse atau MultiUse, proses server lain mungkin atau mungkin tidak akan diluncurkan. Mungkin ini penting perbedaan untuk memutuskan apakah Anda dipaksa harus menutup otomatisasi contoh. Sebagai contoh, dengan server MultiUse, jika contoh sudah dijalankan sebelum Anda melampirkan untuk itu, maka Anda mungkin ingin menghindari menutup Server pemrograman ketika Anda selesai mengotomatisasi itu.

The Tabel berikut berfungsi sebagai referensi membantu ketika menerapkan solusi dengan Microsoft Office. Daftar perilaku dan atribut dari berbagai versi dan aplikasi Microsoft Office, seperti apakah server default untuk menjadi terlihat ketika diluncurkan, jika itu adalah SingleUse atau MultiUse, jika memiliki UserControl properti, jika memiliki Berhenti metode, dan nama kelas untuk jendela utama.


Nama kelas jendela utama membantu untuk panggilan FindWindow API ketika Anda ingin mengetahui nyaman jika setiap contoh sudah berjalan. Properti UserControl adalah properti yang menunjukkan Apakah aplikasi server secara otomatis menutup turun ketika yang terakhir referensi dirilis (ditetapkan untuk apa-apa). The Berhenti metode memungkinkan Anda untuk mengganti properti UserControl dalam kasus di mana ianya perlu (seperti ketika contoh tidak menutup setelah referensi terakhir diluncurkan).

Secara umum, Microsoft menyarankan Anda menggunakan contoh aplikasi Office baru bukan melampirkan untuk contoh yang pengguna dapat menggunakan. Itu adalah terbaik membuat contoh menggunakan Aplikasi ProgID, dan kemudian membuka atau membuat objek baru dari sana. Lainnya ProgIDs, seperti Excel.Sheet dan Word.Document, dan sebagainya, dimaksudkan untuk menggunakan OLE (Object linking and Embedding) dan dapat memberikan hasil yang konsisten Ketika digunakan dengan CreateObject. Dengan menggunakan aplikasi ProgID, Anda menghindari potensi masalah dengan secara eksplisit mulai server untuk otomatisasi (tidak Embedding).

Kapan Anda telah selesai dengan server otomatisasi, melepaskan semua referensi Anda untuk itu dan panggilan yang Berhenti metode (jika tersedia) sehingga server menutup turun seperti yang diharapkan. Jika Anda ingin mengkonfigurasi contoh melalui otomatisasi dan kemudian membiarkannya terbuka untuk pengguna menggunakan, Anda perlu untuk mengatur properti UserControl BENAR dan kemudian melepaskan semua referensi Anda. Kemudian tinggal di server menjalankan (karena properti UserControl BENAR) dan menutup turun tepat ketika pengguna menutup aplikasi (karena tidak ada referensi yang luar biasa).

Catatan Kata, UserControl properti ini hanya bisa dibaca. Tidak diatur ke True atau False. Kata selalu tetap berjalan ketika referensi terakhir dirilis.

Untuk informasi lebih lanjut tentang menggunakan GetObject/CreateObject, dan untuk belajar tentang beberapa pengecualian dan masalah dengan menggunakan otomatisasi untuk Microsoft Office, klik nomor artikel di bawah ini untuk melihat artikel di dalam Basis Pengetahuan Microsoft: