Tindakan Makro ClearMacroError

Pengaturan

Tindakan ClearMacroError tidak memiliki argumen apa pun.

Keterangan

• Ketika kesalahan terjadi di dalam makro, informasi tentang kesalahan itu disimpan dalam objek MacroError. Jika Anda tidak menggunakan tindakan OnError untuk menekankan pesan kesalahan, makro berhenti dan informasi kesalahan ditampilkan dalam pesan kesalahan standar. Namun, jika Anda telah menggunakan tindakan OnError untuk menekankan pesan kesalahan, Anda mungkin ingin menggunakan informasi yang disimpan dalam objek MacroError dalam suatu kondisi atau dalam pesan kesalahan kustom.

  Setelah kesalahan ditangani, informasi dalam objek MacroError sudah basi, jadi ada baiknya menghapus objek dengan menggunakan tindakan ClearMacroError. Dengan melakukan ini akan mereset jumlah kesalahan dalam objek MacroError ke 0 dan menghapus informasi lainnya tentang kesalahan yang disimpan di dalam objek, seperti deskripsi kesalahan, nama makro, nama tindakan, kondisi, dan argumen. Dengan cara ini, Anda dapat memeriksa lagi nanti objek MacroError untuk melihat apakah ada kesalahan lain yang telah terjadi.

• Objek MacroError secara otomatis dihapus saat makro apa pun selesai, jadi Anda tidak perlu menggunakan tindakan ClearMacroError di akhir makro.

• Objek MacroError berisi informasi tentang satu kesalahan saja dalam satu waktu. Jika terdapat lebih dari satu kesalahan terjadi di dalam makro, objek MacroError hanya berisi informasi tentang kesalahan terakhir.

• Untuk menjalankan tindakan ClearMacroError dalam modul VBA, gunakan metode ClearMacroError dari objek DoCmd.

Contoh

Makro berikut ini menggunakan tindakan OnError dengan argumen Berikutnya untuk menekankan pesan kesalahan, lalu menggunakan tindakan OpenForm untuk membuka formulir. Untuk contoh ini, kesalahan sengaja dibuat dengan menggunakan tindakan GoToRecord untuk masuk ke rekaman sebelumnya. Kondisi [MacroError].[Number]<>0 menguji objek MacroError. Jika sebuah kesalahan terjadi, jumlah kesalahan tidak nol, dan tindakan MsgBox akan dijalankan. Kotak pesan menampilkan nama tindakan yang menyebabkan kesalahan (dalam kasus ini, tindakan GoToRecord), dan jumlah kesalahan ditampilkan. Akhirnya, menjalankan tindakan ClearMacroError akan menghapus objek MacroError.