Sdílet prostřednictvím

PosCommon – třída (Dokumentace k sadě POS pro .NET v1.14 SDK)

PosCommonje základní třída pro všechny konkrétní třídy rozhraní a všechny objekty služby jsou z ní nepřímo odvozeny. PosCommon definuje společné vlastnosti, metody a události, které specifikace Unified Point Of Service (UnifiedPOS) vyžaduje ve všech třídách zařízení.

PosCommon – vlastnosti

Následující tabulka popisuje vlastnosti třídy PosCommon dostupné pro aplikace POS.

Vlastnost Type Popis
CapCompareFirmwareVersion bool Určuje, zda objekt služby a zařízení podporuje porovnání verze firmwaru ve fyzickém zařízení se souborem firmwaru.
CapPowerReporting PowerReporting – výčet Označuje možnosti generování sestav výkonu zařízení.
CapStatisticsReporting bool Určuje, jestli se zařízení může nashromáždět a může poskytovat různé statistiky týkající se využití.
CapUpdateStatistics bool Pokud je nastavena hodnota true, některé nebo všechny statistiky zařízení je možné resetovat na hodnotu 0 (nula) pomocí metody ResetStatistic pro jednu aktualizaci a ResetStatistics pro seznam aktualizací nebo aktualizovat pomocí Metody UpdateStatistics pro jednu aktualizaci a Metoda UpdateStatistics pro seznam aktualizací s odpovídajícími zadanými hodnotami.
CapUpdateFirmware bool Určuje, jestli je možné aktualizovat firmware zařízení prostřednictvím metody UpdateFirmware.
CheckHealthText string Označuje stav zařízení.
Tvrdil bool Určuje, jestli je zařízení nárokované pro výhradní přístup.
Popis zařízení string Obsahuje řetězec identifikující zařízení a společnost, která ho vyrábí.
DeviceEnabled bool Určuje, jestli je zařízení v provozním stavu.
DeviceName string UnifiedPOS ji volá PhysicalDeviceName; OLE pro retail POS (OPOS) volá DeviceName.
Devicepath string Nastavení podle POS pro .NET pro zařízení technologie Plug and Play U zařízení, která nejsou technologie Plug and Play, je možné přiřadit cestu DevicePath pomocí konfiguračního souboru.
Ukotvit události bool Pokud je nastavená hodnota true, aplikace požadovala, aby objekt služby nedoručoval události.
PowerNotify Výčet PowerNotification Obsahuje typ výběru oznámení o napájení provedené aplikací.
PowerState PowerState – výčet Obsahuje aktuální stav napájení.
ServiceObjectDescription string Identifikuje objekt služby podporující zařízení a společnost, která ho vytvořila. Tato vlastnost je uvedena jako DeviceServiceDescription ve specifikaci UnifiedPOS.
ServiceObjectVersion System.Version Obsahuje číslo verze objektu služby. Tato vlastnost je uvedena jako DeviceServiceVersion ve specifikaci UnifiedPOS.
Stav Výčet ControlState Uchovává aktuální stav zařízení.
Synchronizingobject ISynchronizeInvoke Získá nebo nastaví zařazování objektu pro volání obslužné rutiny události z události POS.

PosCommon – metody

Následující tabulka popisuje metody Třídy PosCommon dostupné pro aplikace.

Metoda Návratový typ Popis
CheckHealth string Provede kontrolu stavu na zařízení. Typ kontroly, která se má provést, je označen parametrem HealthCheckLevel. Metoda také aktualizuje CheckHealthText vlastnost.
Deklarace identity void Požaduje výhradní přístup k zařízení. Zapisovačům objektů služby se doporučuje vyvolat výjimky pouze v neočekávaných podmínkách; Například OutOfMemory. V opačném případě by objekty služby měly vracet hodnotu True, pokud bylo zařízení deklarované a nepravda, pokud došlo k vypršení časového limitu.
Zavřít void Uvolní zařízení a jeho prostředky.
CompareFirmwareVersion CompareFirmwareResult Určuje, zda je verze zadaného firmwaru novější než, starší nebo stejná jako verze firmwaru ve fyzickém zařízení.
DirectIO DirectIOData Slouží ke komunikaci přímo s objektem služby. Ve specifikaci UnifiedPOS má dva parametry in/out. Jak používá POS pro .NET, tato metoda vrátí strukturu a žádné parametry in/out.
Otevření void Otevře zařízení pro následné zpracování vstupu a výstupu.
Verze void Uvolní výhradní přístup k zařízení.
ResetStatistic void Obnoví zadanou statistiku na nulu. Používá se v POS pro .NET pro operace na jedné statistice.
ResetStatistics void Obnoví všechny statistiky pro zadanou kategorii na 0 (nula).
ResetStatistics void Obnoví zadanou statistiku na hodnotu 0 (nula).
ResetStatistics void Obnoví všechny statistiky přidružené k zařízení na 0 (nula).
RetrieveStatistic string Načte zadanou statistiku zařízení. Používá se v POS pro .NET pro operace na jedné statistice.
RetrieveStatistics string Načte všechny statistiky zařízení.
RetrieveStatistics void Načte statistiku pro zadanou kategorii.
RetrieveStatistics void Načte zadanou statistiku.
UpdateFirmware void Aktualizace firmware zařízení s verzí firmwaru obsaženou v zadaném názvu souboru.
UpdateStatistic void Aktualizace statistiku. Přidáno do pos pro .NET pro operace s jednou statistikou.
UpdateStatistics void Aktualizace seznam statistik s odpovídajícími zadanými hodnotami.
UpdateStatistics void Aktualizace zadanou kategorii statistik se zadanou hodnotou.

PosCommon Events

Následující tabulka popisuje události třídy PosCommon .

metoda Popis
DirectIOEvent Vyvolání objektem služby za účelem přímé komunikace s aplikací.
StatusUpdateEvent Vyvolání objektem služby k upozornění na změnu stavu zařízení.

Příklad

Následující příklad kódu ukazuje, jak používat vlastnosti a metody společné pro všechny Service Objects k zobrazení informací o připojeném zařízení.

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

Viz také

Koncepty

  • Last updated on