Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Di dasar pohon kelas POS untuk Objek Server .NET (Antarmuka, Dasar, Dasar) adalah PosCommon. Kelas ini adalah implementasi langsung dari bab "Properti Umum, Metode, dan Peristiwa" dalam spesifikasi UPOS.
Setiap POS untuk kelas .NET Basic mengambil alih atau mengimplementasikan properti dan metode PosCommon yang sangat penting bagi pengembang Objek Layanan. Topik ini menyediakan informasi tentang metode dan properti ini.
Properti CapPowerReporting
Setelah POS untuk .NET berhasil membuka perangkat, POS mencoba mengambil nilai saat ini dari properti CapPowerReporting. Kelas PowerReporting diinisialisasi ke Tidak Ada, menunjukkan bahwa Objek Layanan tidak dapat memberikan pelaporan daya. Namun, jika perangkat Objek Layanan mendukung pelaporan daya, Objek Layanan dapat mengatur PowerReporting ke Standar atau Tingkat Lanjut dalam metode Objek Layanan.
Properti CapStatisticsReporting
POS untuk .NET memverifikasi bahwa perangkat telah dibuka dan kemudian mengambil nilai properti CapStatisticsReporting saat ini.
Ketika statistik dibuat untuk perangkat, POS untuk .NET mengatur CapStatisticsReporting ke true.
Properti CapUpdateStatistics
POS untuk .NET memverifikasi bahwa perangkat telah dibuka dan kemudian mengambil nilai properti CapUpdateStatistics saat ini.
Ketika statistik dibuat untuk perangkat, dan jika statistik tersebut dapat diatur ulang atau diperbarui, maka POS untuk .NET mengatur CapUpdateStatistics ke true.
Properti yang Diklaim
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai properti Claimed saat ini.
Diklaim diinisialisasi ke false. Diklaim harus diatur ke true ketika aplikasi memanggil Claim(Int32) metode , lalu diatur kembali ke false ketika aplikasi memanggil Release() metode .
Properti DeskripsiPerangkat
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai dari properti DeviceDescription saat ini.
Properti DeviceEnabled
DeviceEnabled adalah properti baca/tulis.
Ini dapat digunakan untuk mengembalikan status objek saat ini; diaktifkan atau dinonaktifkan. Jika objek ini belum dibuka dan diaktifkan sebelumnya, properti ini mengembalikan false.
Properti ini juga digunakan untuk mengaktifkan atau menonaktifkan perangkat dengan mengatur properti nilai ke true atau false. Umum bagi Objek Layanan untuk mengambil alih properti ini dan melakukan inisialisasi dan rilis perangkat kerasnya di sini.
Properti NamaPerangkat
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai DeviceName properti saat ini.
Dalam implementasi kelas Dasar , nilai ini diatur secara otomatis berdasarkan konten ServiceObject atribut.
Jika Anda tidak menurunkan dari kelas Dasar untuk POS .NET, dan sebaliknya menurunkan dari kelas tingkat Interface atau tingkat Dasar, maka DeviceName harus diatur oleh Subjek Layanan selama metode Open().
Properti FreezeEvents
FreezeEvents adalah properti baca/tulis.
POS untuk .NET memverifikasi bahwa perangkat telah dibuka dan diklaim, lalu mengambil atau menetapkan nilai properti FreezeEvents saat ini. Ketika properti ini diatur ke true, POS for .NET akan mengantrekan peristiwa hingga properti ini diatur ke false, namun mekanisme antrean dapat bervariasi dari satu jenis perangkat ke jenis perangkat lainnya.
Properti FreezeEvents diinisialisasi ke false.
Properti PowerNotify
PowerNotify adalah properti baca/tulis.
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil atau mengatur nilai PowerNotify saat ini. Jika PowerNotify diatur, maka pemberitahuan status daya akan dikirim ke aplikasi.
PowerNotify diinisialisasi ke Dinonaktifkan.
Mencoba mengatur PowerNotify dapat menyebabkan pengecualian berikut dilemparkan.
| Nilai | Meaning |
|---|---|
Illegal |
Salah satu kondisi berikut telah terjadi:
|
Properti PowerState
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai saat ini dari properti PowerState. Jika CapPowerReporting diatur ke Tidak Ada, PowerNotify diatur ke Dinonaktifkan, atau DeviceEnabled diatur ke false, PowerState dikembalikan sebagai Tidak Diketahui.
PowerState diinisialisasi ke Tidak Diketahui. Ketika PowerNotify diatur ke Diaktifkan dan DeviceEnabledbenar, PowerState harus diperbarui saat Objek Layanan mendeteksi perubahan kondisi daya. POS untuk .NET mendeteksi perubahan status ketika Service Object mengatur PowerState dan—jika PowerNotify diatur ke Diaktifkan—mengantrekan peristiwa StatusUpdateEvent, memberi tahu aplikasi.
Pengaturan PowerState dapat menyebabkan pengecualian berikut dilemparkan.
| Nilai | Meaning |
|---|---|
Illegal |
Salah satu kondisi berikut telah terjadi:
|
Properti ServiceObjectDescription
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai saat ini dari properti ServiceObjectDescription. Pengembang Objek Layanan seharusnya tidak perlu mengatur nilai ini, karena diatur oleh POS untuk kelas .NET Basic menggunakan informasi deskripsi yang disediakan dalam ServiceObject atribut .
Properti ServiceObjectVersion
POS untuk .NET memverifikasi bahwa perangkat telah dibuka, lalu mengambil nilai saat ini dari properti ServiceObjectVersion. Pengembang Objek Layanan seharusnya tidak perlu mengatur nilai ini, karena diatur oleh POS untuk kelas .NET Basic menggunakan informasi versi yang disediakan dalam ServiceObject atribut .
Properti Negara
Tidak diperlukan verifikasi status perangkat—aplikasi dapat mengambil nilai saat ini dari properti State kapan saja.
Status diinisialisasi ke Ditutup. Jika Objek Layanan menetapkan Status ke nilai yang tidak valid ControlState , POS untuk .NET akan menampilkan pengecualian Ilegal. Perubahan status menyebabkan dalam POS untuk .NET menjadwalkan peristiwa StateChangedEvent.
Metode Pengajuan Klaim
POS untuk .NET memverifikasi bahwa aplikasi telah membuka perangkat.
Jika parameter batas waktu diatur ke nilai kurang dari -1, POS untuk .NET akan memberikan pengecualian. Jika nilai batas waktu diatur ke -1, metode Klaim akan menunggu selamanya.
Jika perangkat sudah diklaim oleh aplikasi, POS untuk .NET hanya mengembalikan.
Jika perangkat sedang digunakan oleh aplikasi lain, batas waktu tercapai; POS untuk .NET memberikan pengecualian waktu habis.
Jika Klaim berhasil, POS untuk .NET memuat statistik untuk perangkat dan mengatur properti Yang Diklaim ke true.
Metode Tutup
Jika aplikasi memanggil metode Close() ketika State diatur ke Closed, POS untuk .NET melempar pengecualian Closed. Jika Status diatur ke Sibuk, POS untuk .NET akan menampilkan pengecualian Sibuk .
Jika metode DeviceEnabled saat Diklaim diatur ke false, POS untuk .NET melemparkan pengecualian tidak sah. Jika Status diatur ke Sibuk, POS untuk .NET memanggil metode ClearOutput . Jika perangkat diaktifkan, POS untuk .NET mengatur DeviceEnabled ke false. POS di .NET menghapus antrean peristiwa, lalu mengatur Diklaim ke false.
Metode ResetStatistic
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim perangkat, dan mengaktifkan perangkat, lalu memanggil metode ResetStatistic(String).
Metode ResetStatistics()
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode ResetStatistics().
Metode ResetStatistics(parameter kategori)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaimkan, dan mengaktifkan perangkat, lalu memanggil metode ResetStatistics(StatisticCategories).
Metode ResetStatistics(string parameter)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode ResetStatistics(String[]).
Metode RetrieveStatistic
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil RetrieveStatistic(String) metode .
Metode RetrieveStatistics()
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, menyetujui, dan mengaktifkan perangkat, lalu memanggil metode RetrieveStatistics().
Metode RetrieveStatistics(categories parameter)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode RetrieveStatistics(StatisticCategories).
Metode RetrieveStatistics(string parameter)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengambil alih, dan mengaktifkan perangkat, lalu memanggil metode RetrieveStatistics(String[]).
Metode UpdateStatistic
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode UpdateStatistic(String, Object).
Metode UpdateStatistics(parameter kategori)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode UpdateStatistics(StatisticCategories, Object).
Metode UpdateStatistics(parameter larik statistik)
POS untuk .NET memverifikasi bahwa aplikasi telah membuka, mengklaim, dan mengaktifkan perangkat, lalu memanggil metode UpdateStatistics(Statistic[]).