Bagikan melalui

POS untuk Kelas Dasar Perangkat .NET (POS untuk Dokumentasi .NET v1.14 SDK)

Setiap perangkat keras di POS untuk .NET diwakili oleh antarmuka abstrak, seperti CashDrawer kelas, dan kelas Dasar , seperti CashDrawerBasic. Kelas dasar berasal dari antarmuka yang mendasar dan berisi dukungan fungsional dasar untuk perangkat. POS untuk .NET menyediakan dukungan umum untuk membuka, mengklaim, dan mengaktifkan perangkat, statistik perangkat, dan untuk mengelola pengiriman peristiwa ke aplikasi. Selain itu, setiap kelas Dasar berisi sekumpulan metode yang diwariskan dan dilindungi yang dapat diimplementasikan oleh Objek Layanan. Topik ini menyediakan informasi ringkasan tentang kelas Dasar yang dapat digunakan oleh Objek Layanan yang berasal dari kelas Dasar perangkat, daripada memanfaatkan kelas Dasar perangkat yang lebih diimplementasikan sepenuhnya.

Konstruktor

Setiap kelas Dasar mencakup konstruktor yang membuat instans kelas dan menginisialisasi statistik untuk versi UPOS, kategori perangkat, dan tanggal penginstalan.

Properti dan Metode Umum

Setiap kelas Dasar menyediakan definisi properti dan metode yang ditimpa PosCommon . Untuk setiap properti dan metode ini, kelas Dasar menangani validasi status—yaitu, verifikasi bahwa aplikasi telah membuka, mengklaim, atau mengaktifkan perangkat—lalu memanggil POS untuk implementasi .NET dari properti atau metode tersebut. Untuk informasi selengkapnya tentang kelas PosCommon , lihat PosCommon.

Objek Layanan dapat menggunakan kelas CommonProperties untuk memperbarui properti PosCommon yang ditunjuk baca-saja untuk aplikasi, atau untuk memperbarui properti tersebut tanpa khawatir tentang validasi status.

Buang Metode

Setiap kelas Dasar mencakup dua metode Buang yang diimplementasikan untuk digunakan oleh Objek Layanan. Untuk informasi tentang cara kerjanya, lihat dokumentasi .NET Framework untuk kelas IDisposable .

Membuka, Mengklaim, dan Mengaktifkan Perangkat

Setiap kelas Dasar menyediakan fungsionalitas inti untuk membuka, mengklaim, dan mengaktifkan perangkat. Namun, biasanya, Objek Layanan ingin mengambil alih metode ini untuk menambahkan pemrosesan kustom mereka sendiri.

Metode dan Peristiwa yang Dilindungi untuk Pengembang Objek Layanan

Setiap kelas Dasar berisi sekelompok metode dan peristiwa untuk pengembang Objek Layanan.

Properti yang dilindungi berikut didefinisikan sebagai berikut:

  • Properti CommonProperties , yang mengembalikan instans CommonProperties dengan dapatkan dan tetapkan nilai untuk semua properti PosCommon . Objek Layanan dapat menggunakan CommonProperties untuk memperbarui properti tanpa khawatir tentang validasi status atau apakah properti ditunjuk baca-saja untuk aplikasi.
  • Properti ExternallyClaimed , yang dapat diambil Objek Layanan untuk menentukan apakah instans lain dari perangkat telah diklaim (dalam hal ini, properti diatur ke true).
  • Properti ErrorCount . Ketika Objek Layanan meminta nilai ErrorCount, kelas dasar memeriksa antrean peristiwa dan meninggikan jumlah peristiwa ErrorEvent yang ditemukan, lalu mengembalikan tally tersebut sebagai nilai ErrorCount.
  • Properti DataCount . POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengembalikan jumlah peristiwa DataEvent yang saat ini diantrekan untuk perangkat.

Metode yang dilindungi berikut didefinisikan:

  • StateChangedEvent dan delegasi StateChangedEventHandler (kelas EventArgs ). Objek Layanan dapat menerapkannya untuk menerima pemberitahuan ketika properti Status perangkat telah berubah.
  • Metode yang dilindungi PreFireEvent untuk setiap jenis peristiwa yang didukung oleh perangkat. Setiap kelas dasar menyediakan implementasi default dan generik dari PreFireEvent yang segera kembali. Jika Objek Layanan perlu memperbarui status internalnya sebelum peristiwa dikirim ke aplikasi, Objek Layanan dapat mengambil alih implementasi default PreFireEvent dan menyediakan implementasinya sendiri untuk jenis peristiwa yang dimaksud.
  • Metode yang dilindungi QueueEvent untuk setiap jenis peristiwa yang didukung oleh perangkat. Objek Layanan memanggil QueueEvent untuk menambahkan peristiwa ke antrean peristiwa. Kelas Dasar memverifikasi bahwa perangkat diaktifkan, lalu menambahkan peristiwa ke antrean peristiwa untuk dikirimkan ke aplikasi. Segera sebelum pengiriman, kelas Dasar memanggil PreFireEvent yang sesuai untuk memberi Objek Layanan kesempatan untuk memperbarui status internalnya. Saat PreFireEvent kembali, kelas Dasar mengirimkan peristiwa ke aplikasi.
  • Metode yang dilindungi QueueEventAndWait . Objek Layanan memanggil QueueEventAndWait untuk menambahkan peristiwa ErrorEvent atau peristiwa DirectIOEvent ke antrean peristiwa, tempat Objek Layanan mengharapkan respons dari aplikasi. Kelas Dasar memverifikasi bahwa perangkat diaktifkan, lalu menambahkan peristiwa ke antrean peristiwa, untuk dikirimkan ke aplikasi ketika kondisi sudah benar. Segera sebelum pengiriman, kelas Dasar memanggil PreFireEvent untuk memberi Objek Layanan kesempatan untuk memperbarui status internalnya. Saat PreFireEvent kembali, kelas Dasar mengirimkan peristiwa ke aplikasi.
  • Metode VerifyState , yang mengambil dua nilai Boolean, mustBeClaimed dan mustBeEnabled. Objek Layanan dapat memanggil POS untuk implementasi .NET dari metode ini untuk melakukan validasi status yang diperlukan untuk perangkat, sebelum metode atau panggilan properti.
  • Metode CreateStatistic . Objek Layanan harus menggunakan metode ini untuk membuat statistik kustom (yaitu khusus produsen). POS untuk .NET menangani pembuatan dan manajemen semua statistik yang ditentukan UPOS.
  • Metode SetStatisticValue dan IncrementStatistic memungkinkan Objek Layanan memperbarui statistik tertentu meskipun tidak didefinisikan sebagai dapat diatur ulang (yaitu, metode ini melewati aturan yang diberlakukan oleh PosCommonResetStatistic(String) dan UpdateStatistic(String, Object) metode).
  • SetStatisticHandlers(String, GetStatistic, SetStatistic) metode, yang memungkinkan Objek Layanan untuk menyediakan fungsi panggilan balik eksternal untuk pengambilan dan pengaturan statistik berbasis perangkat keras. Jika properti get tidak ditentukan, kelas Dasar mengasumsikan bahwa statistik berbasis perangkat lunak, dan nilainya dipertahankan dalam file XML statistik. Jika properti dapatkan dan atur ditentukan, kelas Dasar memanggil fungsi-fungsi ini setiap kali statistik perlu diperbarui atau diatur ulang. Terserah Objek Layanan untuk menyediakan kode untuk memperbarui statistik di perangkat keras.
  • Metode ClearInput . POS untuk .NET menghapus antrean peristiwa untuk perangkat lalu memanggil implementasi Objek Layanan clearInputImpl.
  • Metode ClearInputImpl . Objek Layanan harus menerapkan metode ini untuk menghapus buffer perangkat keras apa pun untuk perangkat.

Lihat Juga

Sumber Daya Lain

  • Last updated on