Bagikan melalui


Properti Kemampuan (POS untuk Dokumentasi .NET v1.14 SDK)

Properti tertentu tidak dapat diatur langsung dalam Objek Layanan. Ini paling sering muncul dalam kasus properti kemampuan; mereka yang memiliki awalan Topi atas nama mereka. Menurut spesifikasi Unified Point Of Service (UnifiedPOS), properti ini harus bersifat baca-saja; oleh karena itu, mekanisme khusus implementasi diperlukan agar Objek Layanan mengubah nilai properti ini.

Properti BaseClass

Microsoft Point of Service untuk kelas Dasar .NET (POS untuk .NET) memiliki properti yang dilindungi, Properti, untuk tujuan ini. Properti ini mengembalikan kelas pembantu yang memiliki versi bisa-tulis dari properti baca-saja yang diterapkan di kelas Dasar . Misalnya, PinPadBase memiliki properti yang disebut Properties yang mengembalikan objek jenis PinPadProperties. Dan objek ini berisi properti yang digunakan untuk mengatur berbagai properti kemampuan khusus PinPad, seperti CapDisplay.

Properti PosCommon

Selain kelas properti khusus perangkat, semua POS untuk kelas Dasar .NET dan Dasar juga memiliki properti yang dilindungi yang disebut CommonProperties yang mengembalikan objek jenis CommonProperties. Kelas pembantu ini digunakan untuk memodifikasi kemampuan dan properti status yang ditemukan di PosCommon.

Mengatur Properti Menggunakan Kelas Pembantu

Secara umum, Objek Layanan harus selalu mengakses nilai properti umum dan khusus kelasnya menggunakan kelas pembantu. Properti ini dapat ditulis oleh Objek Layanan dan selalu berisi nilai yang sesuai.

Pengembang Objek Layanan harus mengetahui apa yang dapat dilakukan POS untuk kerangka kerja .NET ketika nilai tertentu diubah. Misalnya, Objek Layanan umumnya tidak boleh mengubah CommonProperties.State karena ini dapat mengganggu STATUS internal POS untuk .NET. Demikian pula, pengembang Objek Layanan harus menyadari bahwa mengubah CommonProperties.PowerState dapat mengirim peristiwa StatusUpdateEvent ke aplikasi.

Catatan

Saat berasal dari POS untuk kelas Dasar .NET atau Dasar, Objek Layanan umumnya tidak boleh mengubah nilai CommonProperties.State menjadi ControlState.Closed. Melakukannya mencegah pembersihan antrean peristiwa, dan POS untuk .NET nantinya dapat melemparkan pengecualian karena mencoba memproses peristiwa yang sudah ada dalam antrean.

Lihat juga