Udostępnij przez


Klasa PosCommon (POS dla zestawu SDK platformy .NET w wersji 1.14)

PosCommonjest klasą bazową dla wszystkich określonych klas interfejsu, a wszystkie obiekty usługi pośrednio pochodzą z niej. PosCommon definiuje typowe właściwości, metody i zdarzenia, których specyfikacja Unified Point Of Service (Unified Point Of Service) wymaga we wszystkich klasach urządzeń.

Właściwości posCommon

W poniższej tabeli opisano właściwości klasy PosCommon dostępnej dla aplikacji POS.

Właściwość Type Opis
CapCompareFirmwareVersion bool Wskazuje, czy obiekt usługi i urządzenie obsługuje porównywanie wersji oprogramowania układowego w urządzeniu fizycznym z plikiem oprogramowania układowego.
CapPowerReporting PowerReporting, wyliczenie Wskazuje możliwości raportowania zasilania urządzenia.
CapStatisticsReporting bool Wskazuje, czy urządzenie może gromadzić się i może udostępniać różne statystyki dotyczące użycia.
CapUpdateStatistics bool Jeśli ustawiono wartość true, niektóre lub wszystkie statystyki urządzeń można zresetować do wartości 0 (zero) przy użyciu metody ResetStatistic dla jednej aktualizacji i metody ResetStatistics dla listy aktualizacji lub zaktualizować przy użyciu metody UpdateStatistics dla jednej aktualizacji i metody UpdateStatistics dla listy aktualizacji z odpowiednimi określonymi wartościami.
CapUpdateFirmware bool Wskazuje, czy oprogramowanie układowe urządzenia można zaktualizować za pomocą metody UpdateFirmware.
CheckHealthText string Wskazuje kondycję urządzenia.
Twierdził bool Wskazuje, czy urządzenie jest żądane w celu uzyskania wyłącznego dostępu.
DeviceDescription string Przechowuje ciąg identyfikujący urządzenie i firmę, która ją wyprodukowała.
DeviceEnabled bool Wskazuje, czy urządzenie jest w stanie operacyjnym.
Nazwa urządzenia string UnifiedPOS nazywa ją PhysicalDeviceName; Obiekt OLE dla rozwiązania Retail POS (OPOS) wywołuje nazwę DeviceName.
Devicepath string Ustawiane przez usługę POS dla platformy .NET dla urządzeń Plug and Play. W przypadku urządzeń innych niż Plug and Play można przypisać program DevicePath przy użyciu pliku konfiguracji.
FreezeEvents bool Po ustawieniu wartości true aplikacja zażądała, aby obiekt usługi nie dostarczał zdarzeń.
PowerNotify Wyliczenie PowerNotification Przechowuje typ wyboru powiadomienia o zasilaniu dokonanego przez aplikację.
PowerState Wyliczenie PowerState Przechowuje bieżący stan zasilania.
ServiceObjectDescription string Identyfikuje obiekt usługi obsługujący urządzenie i firmę, która ją wyprodukowała. Ta właściwość jest wymieniona jako DeviceServiceDescription w specyfikacji UnifiedPOS.
ServiceObjectVersion System.Version Przechowuje numer wersji obiektu usługi. Ta właściwość jest wymieniona jako DeviceServiceVersion w specyfikacji UnifiedPOS.
Stan Wyliczenie ControlState Przechowuje bieżący stan urządzenia.
Synchronizingobject Isynchronizeinvoke Pobiera lub ustawia obiekt marshalling dla wywołań programu obsługi zdarzeń ze zdarzenia POS.

PosCommon, metody

W poniższej tabeli opisano metody klasy PosCommon dostępne dla aplikacji.

Metoda Zwracany typ opis
Sprawdzanie kondycji string Wykonuje kontrolę kondycji na urządzeniu. Typ sprawdzania do wykonania jest wskazywany przez parametr HealthCheckLevel. Metoda aktualizuje również właściwość CheckHealthText.
Oświadczenie void Żąda wyłącznego dostępu do urządzenia. Zalecane jest zgłaszanie wyjątków tylko w nieoczekiwanych warunkach. na przykład OutOfMemory. W przeciwnym razie obiekty usługi powinny zwracać wartość True, jeśli urządzenie zostało zgłoszone i wartość False, jeśli wystąpił limit czasu.
Zamknij void Zwalnia urządzenie i jego zasoby.
CompareFirmwareVersion CompareFirmwareResult Określa, czy wersja określonego oprogramowania układowego jest nowsza niż, starsza niż, czy taka sama jak wersja oprogramowania układowego w urządzeniu fizycznym.
DirectIO DirectIOData Służy do bezpośredniej komunikacji z obiektem usługi. W specyfikacji UnifiedPOS ma dwa parametry w/wy. Jako używana przez usługę POS dla platformy .NET ta metoda zwraca strukturę i nie ma parametrów w/wy.
Otwarcie void Otwiera urządzenie do późniejszego przetwarzania danych wejściowych/wyjściowych.
Zwolnij void Zwalnia wyłączny dostęp do urządzenia.
ResetStatistic void Resetuje określoną statystykę do zera. Używany w usłudze POS dla platformy .NET na potrzeby operacji w pojedynczej statystyce.
ResetStatistics void Resetuje wszystkie statystyki dla określonej kategorii na 0 (zero).
ResetStatistics void Resetuje określone statystyki do wartości 0 (zero).
ResetStatistics void Resetuje wszystkie statystyki skojarzone z urządzeniem do wartości 0 (zero).
PobierzStatystyka string Pobiera określoną statystykę urządzenia. Używany w usłudze POS dla platformy .NET na potrzeby operacji w pojedynczej statystyce.
RetrieveStatistics string Pobiera wszystkie statystyki urządzeń.
RetrieveStatistics void Pobiera statystyki dla określonej kategorii.
RetrieveStatistics void Pobiera określone statystyki.
UpdateFirmware void Aktualizacje oprogramowanie układowe urządzenia z wersją oprogramowania układowego zawartego w określonej nazwie pliku.
UpdateStatistic void Aktualizacje statystykę. Dodano do usługi POS dla platformy .NET na potrzeby operacji w pojedynczej statystyce.
Updatestatistics void Aktualizacje listę statystyk z odpowiednimi określonymi wartościami.
Updatestatistics void Aktualizacje określoną kategorię statystyk z określoną wartością.

Zdarzenia PosCommon

W poniższej tabeli opisano zdarzenia klasy PosCommon .

Metoda opis
DirectIOEvent Wywoływane przez obiekt usługi w celu przekazywania informacji bezpośrednio do aplikacji.
StatusUpdateEvent Zgłoszone przez obiekt usługi w celu alertu dotyczącego zmiany stanu urządzenia.

Przykład

W poniższym przykładzie kodu pokazano, jak używać właściwości i metod wspólnych dla wszystkich obiektów usługi do wyświetlania informacji o połączonym urządzeniu.

// 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();

Zobacz też

Pojęcia