Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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();