Bagikan melalui

Penanganan Pengecualian POS (POS untuk Dokumentasi .NET v1.14 SDK)

Penanganan kesalahan di Microsoft Point of Service untuk .NET (POS untuk .NET) dibangun pada model berorientasi objek untuk melempar dan menangkap pengecualian. Pengecualian yang berbeda dilemparkan sebagai respons terhadap kesalahan runtime, dan setiap pengecualian berisi informasi tentang kesalahan yang memicunya dalam bentuk ErrorCode.

Properti ErrorCode dari pengecualian yang dilemparkan menyimpan informasi tentang penyebab kesalahan. Nilai yang mungkin untuk properti ini mewakili kumpulan lengkap kode kesalahan Unified Point Of Service (UnifiedPOS) standar. Untuk informasi lebih lanjut tentang pemetaan antara kode kesalahan UnifiedPOS dan nilai ErrorCode dalam POS untuk .NET, lihat Kelas Pengecualian POS untuk .NET.

POS untuk .NET menyediakan empat kelas pengecualian untuk membantu aplikasi menangani kesalahan dengan lebih baik. Ini adalah PosException, PosControlException, PosManagementException, dan PosLibraryException:

  • PosException adalah kelas abstrak yang menyimpan data pengecualian umum. PosException memenuhi peran yang mirip dengan kelas System.Exception di .NET Framework, dan merupakan POS untuk implementasi .NET dari kelas UposException dalam spesifikasi UnifiedPOS. Semua POS lainnya untuk kelas pengecualian .NET berasal dari PosException.
  • PosControlException adalah pengecualian standar yang dilemparkan oleh POS untuk Objek Layanan .NET. PosControlException berisi ErrorCode properti yang menyimpan informasi tentang penyebab pengecualian.
  • PosLibraryException menyimpan data pengecualian yang dihasilkan oleh PosExplorer selama operasi kelas. PosLibraryException tidak berisi properti ErrorCode .
  • PosManagementException menyimpan data pengecualian yang dihasilkan oleh POS untuk API manajemen .NET. PosManagementException tidak berisi properti ErrorCode .

Penanganan Kesalahan di POS untuk .NET

Penanganan kesalahan di POS untuk .NET mematuhi pedoman spesifikasi UnifiedPOS. Penanganan kesalahan digerakkan oleh peristiwa, menggunakan kode kesalahan untuk menyimpan informasi pengecualian, dan sebagian besar spesifik implementasi.

Menangani kesalahan di POS untuk .NET mengikuti prosedur umum ini:

  1. Kesalahan dipicu oleh input berbasis peristiwa.

  2. Perangkat mengubah propertinya State untuk menunjukkan bahwa perangkat mengalami kesalahan.

  3. Peristiwa ErrorEvent diantrekan untuk memperingatkan aplikasi bahwa terjadi kesalahan. ErrorEvent ditambahkan ke akhir antrean.

  4. Jika satu atau beberapa peristiwa DataEvent diantrekan sebelum peristiwa ErrorEvent, ErrorEvent lain diantrekan dan ditempatkan di awal antrean. Ini memperingatkan aplikasi tentang kesalahan dengan cepat sehingga dapat merespons dengan cara khusus implementasi sebelum memproses DataEvents yang diantrekan.

  5. Jika properti aplikasi dikonfigurasi untuk menerima peristiwa (DataEventEnabledbenar dan FreezeEventssalah), properti tersebut merespons peristiwa ErrorEvent dengan cara yang ditentukan oleh ErrorResponse properti, seperti yang ditunjukkan dalam tabel berikut.

    Nilai Arti Tanggapan
    Clear Menghapus peristiwa DataEvent yang di-buffer dan peristiwa ErrorEvent, keluar dari status Kesalahan, dan mengubah Status perangkat menjadi Menganggur.
    LanjutkanInput Mengakui kesalahan dan mengarahkan perangkat untuk terus memproses. Perangkat tetap dalam status Kesalahan dan akan mengirimkan peristiwa data tambahan seperti yang diarahkan oleh properti DataEventEnabled. Ketika semua input telah dikirimkan, dan properti DataEventEnabled kembali diatur ke true, ErrorEvent lain dikirimkan dengan locus Input.
    Coba Ulang Mengarahkan perangkat untuk mencoba kembali input. Status Kesalahan dihentikan, dan Status diubah menjadi Siaga. Respons ini hanya dipilih ketika bab perangkat secara khusus mengizinkannya dan ketika lokusnya adalah Input.

    Aplikasi juga dapat mengambil langkah-langkah khusus implementasi untuk merespons kesalahan saat ini.

Lihat Juga

Reference

Konsep

  • Last updated on