Kelas PosCommon (POS untuk Dokumentasi .NET v1.14 SDK)

PosCommonadalah kelas Dasar untuk semua kelas Antarmuka tertentu, dan semua Objek Layanan secara tidak langsung berasal darinya. PosCommon mendefinisikan properti, metode, dan peristiwa umum yang diperlukan spesifikasi Unified Point Of Service (UnifiedPOS) di semua kelas perangkat.

Properti PosCommon

Tabel berikut menjelaskan properti kelas PosCommon yang tersedia untuk aplikasi POS.

Properti	Tipe	Deskripsi
CapCompareFirmwareVersion	bool	Menunjukkan apakah Objek Layanan dan perangkat mendukung perbandingan versi firmware di perangkat fisik dengan file firmware.
CapPowerReporting	Enum PowerReporting	Menunjukkan kemampuan pelaporan daya perangkat.
CapStatisticsReporting	bool	Menunjukkan apakah perangkat dapat terakumulasi dan dapat memberikan berbagai statistik mengenai penggunaan.
CapUpdateStatistics	bool	Jika diatur ke true, beberapa atau semua statistik perangkat dapat diatur ulang ke 0 (nol) menggunakan metode ResetStatistic untuk satu metode pembaruan dan ResetStatistics untuk daftar pembaruan, atau diperbarui menggunakan metode UpdateStatistic untuk satu pembaruan dan metode UpdateStatistics untuk daftar pembaruan dengan nilai yang ditentukan yang sesuai.
CapUpdateFirmware	bool	Menunjukkan apakah firmware perangkat dapat diperbarui melalui metode UpdateFirmware.
CheckHealthText	string	Menunjukkan kesehatan perangkat.
Mengklaim	bool	Menunjukkan apakah perangkat diklaim untuk akses eksklusif.
DeviceDescription	string	Memegang string yang mengidentifikasi perangkat dan perusahaan yang memproduksinya.
DeviceEnabled	bool	Menunjukkan apakah perangkat dalam status operasional.
DeviceName	string	UnifiedPOS menyebutnya PhysicalDeviceName; OLE untuk RETAIL POS (OPOS) menyebutnya DeviceName.
DevicePath	string	Diatur oleh POS untuk .NET untuk perangkat Plug and Play. Untuk perangkat non-Plug and Play, DevicePath dapat ditetapkan menggunakan file konfigurasi.
FreezeEvents	bool	Ketika diatur ke true, aplikasi telah meminta agar Objek Layanan tidak mengirimkan peristiwa.
PowerNotify	Enum PowerNotification	Menyimpan jenis pilihan pemberitahuan daya yang dibuat oleh aplikasi.
PowerState	Enum PowerState	Menahan kondisi daya saat ini.
ServiceObjectDescription	string	Mengidentifikasi Objek Layanan yang mendukung perangkat dan perusahaan yang memproduksinya. Properti ini terdaftar sebagai DeviceServiceDescription dalam spesifikasi UnifiedPOS.
ServiceObjectVersion	System.Version	Menyimpan nomor versi Objek Layanan. Properti ini terdaftar sebagai DeviceServiceVersion dalam spesifikasi UnifiedPOS.
Provinsi	Enum ControlState	Memegang status perangkat saat ini.
MenyinkronkanObject	ISynchronizeInvoke	Mendapatkan atau mengatur objek marshalling untuk panggilan penanganan aktivitas dari peristiwa POS.

Metode PosCommon

Tabel berikut menjelaskan metode kelas PosCommon yang tersedia untuk aplikasi.

Metode	Jenis Hasil	Deskripsi
CheckHealth	string	Melakukan pemeriksaan kesehatan pada perangkat. Jenis pemeriksaan yang akan dilakukan ditunjukkan oleh parameter HealthCheckLevel. Metode ini juga memperbarui properti CheckHealthText.
Klaim	batal	Meminta akses eksklusif ke perangkat. Penulis Objek Layanan disarankan untuk hanya melemparkan pengecualian dalam kondisi yang tidak terduga; misalnya, OutOfMemory. Jika tidak, Objek Layanan harus mengembalikan True jika perangkat diklaim dan False jika terjadi waktu habis.
Tutup	batal	Merilis perangkat dan sumber dayanya.
CompareFirmwareVersion	CompareFirmwareResult	Menentukan apakah versi firmware yang ditentukan lebih baru dari, lebih lama dari, atau sama dengan versi firmware di perangkat fisik.
DirectIO	DirectIOData	Digunakan untuk berkomunikasi langsung dengan Objek Layanan. Dalam spesifikasi UnifiedPOS, ia memiliki dua parameter masuk/keluar. Seperti yang digunakan oleh POS untuk .NET, metode ini mengembalikan struktur dan tidak ada parameter masuk/keluar.
Buka	batal	Membuka perangkat untuk pemrosesan input/output berikutnya.
Lepaskan	batal	Merilis akses eksklusif ke perangkat.
ResetStatistic	batal	Mereset statistik yang ditentukan menjadi nol. Digunakan dalam POS untuk .NET untuk operasi pada satu statistik.
ResetStatistics	batal	Mereset semua statistik untuk kategori tertentu menjadi 0 (nol).
ResetStatistics	batal	Mereset statistik yang ditentukan menjadi 0 (nol).
ResetStatistics	batal	Mengatur ulang semua statistik yang terkait dengan perangkat menjadi 0 (nol).
RetrieveStatistic	string	Mengambil statistik perangkat yang ditentukan. Digunakan dalam POS untuk .NET untuk operasi pada satu statistik.
RetrieveStatistics	string	Mengambil semua statistik perangkat.
RetrieveStatistics	batal	Mengambil statistik untuk kategori yang ditentukan.
RetrieveStatistics	batal	Mengambil statistik yang ditentukan.
UpdateFirmware	batal	Memperbarui firmware perangkat dengan versi firmware yang terkandung dalam nama file yang ditentukan.
UpdateStatistic	batal	Memperbarui statistik. Ditambahkan ke POS untuk .NET untuk operasi pada satu statistik.
UpdateStatistics	batal	Memperbarui daftar statistik dengan nilai yang ditentukan terkait.
UpdateStatistics	batal	Memperbarui kategori statistik yang ditentukan dengan nilai yang ditentukan.

Peristiwa PosCommon

Tabel berikut ini menjelaskan peristiwa kelas PosCommon .

Metode	Deskripsi
DirectIOEvent	Dibesarkan oleh Objek Layanan untuk mengomunikasikan informasi langsung ke aplikasi.
StatusUpdateEvent	Dinaikkan oleh Objek Layanan untuk memperingatkan aplikasi perubahan status perangkat.

Contoh

Contoh kode berikut menunjukkan cara menggunakan properti dan metode yang umum untuk semua Objek Layanan untuk menampilkan informasi tentang perangkat yang terhubung.

// Create a derived class of PosCommon
public class PosCommonSample: PosCommon
{
    // Implement all base methods and properties.
    // ...
}

// Create instances for the example.
PosExplorer explorer = new PosExplorer();
PosCommonSample pcs = new PosCommonSample();
DeviceInfo device = explorer.GetDevice("MSR");
pcs = (PosCommonSample)explorer.CreateInstance(device);

// Open and claim the device, then print information
// about the device to the console.
pcs.Open();
pcs.Claim(1000);
Console.WriteLine("Name: {0}", pcs.DeviceName);
Console.WriteLine("Description: {0}", pcs.DeviceDescription);
Console.WriteLine("Path: {0}", pcs.DevicePath);
Console.WriteLine("Enabled: {0}", pcs.DeviceEnabled);

pcs.Close();

Lihat Juga

Konsep

• POS untuk Pohon Kelas .NET