Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Základem poS pro strom třídy objektů serveru .NET (Interface, Basic, Base) je PosCommon. Tato třída je přímá implementace kapitoly "Společné vlastnosti, metody a události" ve specifikaci UPOS.
Každý POS pro třídu .NET Basic přepíše nebo implementuje vlastnosti a metody PosCommon , které jsou pro vývojáře objektu služby obzvláště důležité. Toto téma obsahuje informace o těchto metodách a vlastnostech.
CapPowerReporting – vlastnost
Jakmile POS for .NET úspěšně otevře zařízení, pokusí se načíst aktuální hodnotu vlastnosti CapPowerReporting. Třída PowerReporting je inicializována na None, což znamená, že Objekt služby nemůže poskytovat hlášení o výkonu. Pokud však zařízení objektu služby podporuje generování sestav výkonu, objekt služby může v metodě objektu služby nastavit PowerReporting na standardní nebo pokročilý.
Vlastnost CapStatisticsReporting
POS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu CapStatisticsReporting vlastnosti.
Při vytváření statistik pro zařízení nastaví POS pro .NET CapStatisticsReporting na true.
CapUpdateStatistics – vlastnost
POS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu CapUpdateStatistics vlastnosti.
Při vytváření statistik pro zařízení a pokud je možné tyto statistiky resetovat nebo aktualizovat, poS pro .NET nastaví CapUpdateStatistics natrue.
Nárokovaný majetek
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu Claimed vlastnosti.
Nárok je inicializován jako false. Deklarace by měla být nastavena na true, když aplikace volá metoduClaim(Int32), a pak se při volání metody nastaví zpět na Release().
DeviceDescription – vlastnost
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu DeviceDescription vlastnosti.
DeviceEnabled – Vlastnost
DeviceEnabled je vlastnost pro čtení a zápis.
Lze jej použít k vrácení aktuálního stavu objektu; povoleno nebo zakázáno. Pokud tento objekt nebyl dříve otevřen a povolen, tato vlastnost vrátí hodnotu false.
Tato vlastnost se také používá k povolení nebo zakázání zařízení nastavením vlastnosti hodnoty na true nebo false. Pro objekty služby je běžné přepsat tuto vlastnost a provést její inicializaci a vydání hardwaru zde.
DeviceName – vlastnost
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu DeviceName vlastnosti.
V rámci implementace základní třídy je tato hodnota nastavena automaticky na základě obsahu atributu ServiceObject .
Pokud neodvozujete z POS pro .NET třídu Base a místo toho odvozujete z rozhraní na úrovni Interface nebo z třídy na úrovni Basic, měl by být DeviceName nastaven Subjektem služby během Open() metody.
FreezeEvents – vlastnost
FreezeEvents je vlastnost pro čtení a zápis.
POS pro .NET ověří, že zařízení bylo otevřeno a deklarováno, poté načte nebo nastaví aktuální hodnotu vlastnosti FreezeEvents. Pokud je tato vlastnost nastavena na true, POS for .NET řadí události do fronty, dokud není tato vlastnost nastavena na false, přičemž mechanismus řazení se může lišit podle typu zařízení.
Vlastnost FreezeEvents je inicializována na false.
PowerNotify – vlastnost
PowerNotify je vlastnost pro čtení a zápis.
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte nebo nastaví aktuální hodnotu PowerNotify. Pokud je nastavená funkce PowerNotify , budou se do aplikace odesílat oznámení o stavu napájení.
PowerNotify se inicializuje na zakázáno.
Pokus o nastavení PowerNotify může způsobit vyvolání následujících výjimek.
| Hodnota | Význam |
|---|---|
Illegal |
Došlo k jedné z následujících podmínek:
|
Vlastnost PowerState
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu PowerState vlastnosti. Pokud je CapPowerReporting nastavena na None, PowerNotify je nastavena na Zakázáno nebo DeviceEnabled nastavena na false, PowerState se vrátí jako Neznámý.
PowerState se inicializuje na neznámý. Pokud je PowerNotify nastavena na Povoleno a DeviceEnabled je true, PowerState by se měl aktualizovat, protože objekt služby detekuje změny stavu napájení. POS pro .NET zjistí změnu stavu, když objekt služby nastaví PowerState. Pokud je PowerNotify nastaveno na Povoleno, zařadí událost StatusUpdateEvent do fronty a upozorní aplikaci.
Nastavení PowerState může způsobit vyvolání následujících výjimek.
| Hodnota | Význam |
|---|---|
Illegal |
Došlo k jedné z následujících podmínek:
|
ServiceObjectDescription – vlastnost
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu ServiceObjectDescription vlastnosti. Vývojář objektu služby by neměl tuto hodnotu nastavovat, protože je nastavena poS pro třídu .NET Basic pomocí popisových informací uvedených v atributu ServiceObject .
ServiceObjectVersion – vlastnost
PoS pro .NET ověří, že zařízení bylo otevřeno, a pak načte aktuální hodnotu ServiceObjectVersion vlastnosti. Vývojář objektu služby by neměl tuto hodnotu nastavovat, protože je nastavena poS pro třídu .NET Basic pomocí informací o verzi uvedené v atributu ServiceObject .
Státní majetek
Nevyžaduje se žádné ověření stavu zařízení – aplikace může kdykoli načíst aktuální hodnotu State property.at.
Stav je inicializován na uzavřeno. Pokud objekt služby nastaví stav na neplatnou ControlState hodnotu, poS pro .NET vyvolá neplatnou výjimku. Změny stavu způsobují, že POS pro .NET zařadí událost StateChangedEvent do fronty.
Metoda uplatnění nároku
POS pro .NET ověřuje, že aplikace má otevřené zařízení.
Pokud je parametr časového limitu nastaven na hodnotu menší než -1, poS pro .NET vyvolá výjimku. Pokud je hodnota časového limitu nastavena na -1, metoda Claim bude čekat navždy.
Pokud je zařízení již přiřazeno aplikací, POS pro .NET jednoduše vrátí.
Pokud zařízení používá jiná aplikace, dojde k vypršení časového limitu ; PoS pro .NET vyvolá výjimku časového limitu.
Pokud nárok je úspěšný, POS pro .NET načte statistiky pro zařízení a nastaví nárokovanou vlastnost na true.
Metoda zavření
Pokud aplikace volá metodu Close() , když je stav nastaven na Uzavřeno, poS pro .NET vyvolá uzavřenou výjimku. Pokud je stav nastaven na Zaneprázdněn, poS pro .NET vyvolá výjimku Zaneprázdněn .
Pokud je metoda DeviceEnabled a Claimed je nastavena na false, POS pro .NET vyvolá výjimku Illegal. Pokud je State nastaven na Zaneprázdněn, POS pro .NET volá metodu ClearOutput. Pokud je zařízení povoleno, POS pro .NET nastaví DeviceEnabled na false. PoS pro .NET vymaže frontu událostí a pak nastaví zajmutí na false.
ResetStatistic – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu ResetStatistic(String) .
ResetStatistics() – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu ResetStatistics() .
ResetovatStatistiky(parametr kategorie) – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu ResetStatistics(StatisticCategories) .
ResetStatistics(string parameter) – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu ResetStatistics(String[]) .
Metoda RetrieveStatistic
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu RetrieveStatistic(String) .
RetrieveStatistics() – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu RetrieveStatistics() .
RetrieveStatistics("kategorie parametr") : metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu RetrieveStatistics(StatisticCategories) .
RetrieveStatistics(string parameter) – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu RetrieveStatistics(String[]) .
UpdateStatistic – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu UpdateStatistic(String, Object) .
AktualizovatStatistiky(kategorie parametr) – metoda
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu UpdateStatistics(StatisticCategories, Object) .
Metoda UpdateStatistics(statistické pole parametr)
PoS pro .NET ověří, že aplikace otevřela, deklarovala a povolila zařízení, a pak volá metodu UpdateStatistics(Statistic[]) .
Viz také
Odkazy
Koncepce
Další zdroje informací
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.
