Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Alla base dell'albero delle classi dell'oggetto POS per .NET Server (Interface, Basic, Base) è PosCommon. Questa classe è un'implementazione diretta del capitolo "Proprietà comuni, metodi ed eventi" nella specifica UPOS.
Ogni POS per la classe .NET Basic esegue l'override o implementa le proprietà e i metodi PosCommon che sono di particolare importanza per uno sviluppatore di Service Object. In questo argomento vengono fornite informazioni su questi metodi e proprietà.
CapPowerReporting, proprietà
Dopo che POS per .NET ha aperto correttamente un dispositivo, tenta di recuperare il valore corrente della CapPowerReporting proprietà. La PowerReporting classe viene inizializzata su Nessuno, a indicare che l'oggetto servizio non è in grado di fornire report di risparmio energia. Se, tuttavia, il dispositivo dell'oggetto servizio supporta la creazione di report sull'alimentazione, l'oggetto servizio può impostare PowerReporting su Standard o Avanzato nel metodo dell'oggetto servizio.
Proprietà 'CapStatisticsReporting'
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della CapStatisticsReporting proprietà.
Quando vengono create statistiche per il dispositivo, POS per .NET imposta CapStatisticsReporting su true.
Proprietà CapUpdateStatistics
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della CapUpdateStatistics proprietà.
Quando vengono create statistiche per il dispositivo e se queste statistiche possono essere reimpostate o aggiornate, POS per .NET imposta CapUpdateStatistics su true.
Proprietà reclamata
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della Claimed proprietà.
Claimed è inizializzato su false. Il valore Claimed deve essere impostato su true quando l'applicazione chiama il metodo Claim(Int32), quindi deve essere impostato su false quando l'applicazione chiama il metodo Release().
Proprietà di Descrizione del Dispositivo
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della DeviceDescription proprietà.
DeviceEnabled, proprietà
DeviceEnabled è una proprietà di lettura/scrittura.
Può essere usato per restituire lo stato corrente dell'oggetto; abilitato o disabilitato. Se questo oggetto non è stato aperto e abilitato in precedenza, questa proprietà restituisce false.
Questa proprietà viene usata anche per abilitare o disabilitare il dispositivo impostando la proprietà del valore su true o false. È comune per i Service Objects eseguire l'override di questa proprietà ed effettuare qui l'inizializzazione e il rilascio dell'hardware.
Proprietà DeviceName
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della DeviceName proprietà.
All'interno delle implementazioni della classe base , questo valore viene impostato automaticamente in base al contenuto dell'attributo ServiceObject .
Se non si deriva da una classe POS per .NET Base e si deriva invece da una classe a livello di interfaccia o di base, DeviceName deve essere impostato dall'oggetto del servizio durante il Open() metodo .
Proprietà FreezeEvents
FreezeEvents è una proprietà di lettura/scrittura.
POS per .NET verifica che il dispositivo sia stato aperto e richiesto, quindi recupera o imposta il valore corrente della proprietà FreezeEvents . Quando questa proprietà è impostata su true, POS per .NET accoda gli eventi finché questa proprietà non è impostata su false, non che il meccanismo di accodamento può variare da un tipo di dispositivo a un altro.
La proprietà FreezeEvents viene inizializzata su false.
PowerNotify proprietà
PowerNotify è una proprietà di lettura/scrittura.
POS per .NET verifica che il dispositivo sia stato aperto, quindi recupera o imposta il valore corrente di PowerNotify. Se PowerNotify è impostato, le notifiche sullo stato di alimentazione verranno inviate all'applicazione.
PowerNotify viene inizializzato su Disabled.
Il tentativo di impostare PowerNotify può causare la generazione delle eccezioni seguenti.
| Valore | significato |
|---|---|
Illegal |
Si è verificata una delle condizioni seguenti:
|
PowerState, proprietà
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della PowerState proprietà. Se CapPowerReporting è impostato su Nessuno, PowerNotify è impostato su Disabilitato o DeviceEnabled impostato su false, PowerState viene restituito come Sconosciuto.
PowerState viene inizializzato su Sconosciuto. Quando PowerNotify è impostato su Enabled e DeviceEnabled è true, PowerState deve essere aggiornato quando l'oggetto servizio rileva le modifiche della condizione di alimentazione. POS per .NET rileva la modifica dello stato quando l'oggetto servizio imposta PowerState e, se PowerNotify è impostato su Enabled, accoda un StatusUpdateEvent evento, notificando all'applicazione.
L'impostazione PowerState può causare la generazione delle eccezioni seguenti.
| Valore | significato |
|---|---|
Illegal |
Si è verificata una delle condizioni seguenti:
|
ServiceObjectDescription Proprietà
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della ServiceObjectDescription proprietà. Lo sviluppatore dell'oggetto servizio non deve impostare questo valore, poiché è impostato dalla classe POS per .NET Basic usando le informazioni di descrizione fornite nell'attributo ServiceObject .
Proprietà ServiceObjectVersion
POS per .NET verifica che il dispositivo sia stato aperto e quindi recupera il valore corrente della ServiceObjectVersion proprietà. Lo sviluppatore dell'oggetto servizio non deve impostare questo valore, poiché è impostato dalla classe POS per .NET Basic usando le informazioni sulla versione fornite nell'attributo ServiceObject .
Proprietà dello Stato
Non è richiesta alcuna verifica dello stato del dispositivo: l'applicazione può recuperare il valore corrente del State property.at in qualsiasi momento.
Lo stato viene inizializzato su Closed. Se l'Oggetto servizio imposta Lo stato su un valore ControlState non valido, POS per .NET genera un'eccezione Illegal. Le modifiche allo stato causano l'accodamento di un evento StateChangedEvent nel POS per .NET.
Metodo di Richiesta
POS per .NET verifica che l'applicazione abbia aperto il dispositivo.
Se il parametro di timeout è impostato su un valore minore di -1, POS per .NET genera un'eccezione. Se il valore di timeout è impostato su -1, il metodo Claim attenderà per sempre.
Se il dispositivo è già richiesto dall'applicazione, POS per .NET semplicemente restituisce.
Se il dispositivo è in uso da un'altra applicazione, viene raggiunto il timeout ; POS per .NET genera un'eccezione di timeout.
Se Claim ha esito positivo, POS per .NET carica le statistiche del dispositivo e imposta la proprietà Claimed su true.
Metodo Close
Se l'applicazione chiama il Close() metodo quando State è impostato su Closed, POS per .NET genera un'eccezione Closed . Se State è impostato su Occupato, POS per .NET genera un'eccezione Occupato .
Se il metodo DeviceEnabled quando Claimed è impostato su false, POS per .NET genera un'eccezione Non valida. Se State è impostato su Occupato, POS per .NET chiama il metodo ClearOutput . Se il dispositivo è abilitato, POS per .NET imposta DeviceEnabled su false. POS per .NET cancella la coda di eventi e quindi imposta Claimed sufalse.
Metodo ResetStatistic
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il ResetStatistic(String) metodo .
Metodo ResetStatistics()
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il ResetStatistics() metodo .
Metodo ReimpostaStatistiche(parametro categorie)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il ResetStatistics(StatisticCategories) metodo .
Metodo ResetStatistics(parametro string)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il ResetStatistics(String[]) metodo .
RetrieveStatistic, Metodo
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il RetrieveStatistic(String) metodo .
Metodo RetrieveStatistics()
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il RetrieveStatistics() metodo .
Il Metodo RetrieveStatistics(categories parameter)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il RetrieveStatistics(StatisticCategories) metodo .
Metodo RetrieveStatistics(parametro string)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il RetrieveStatistics(String[]) metodo .
UpdateStatistic Metodo
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il UpdateStatistic(String, Object) metodo .
Metodo UpdateStatistics(categories parameter)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il UpdateStatistics(StatisticCategories, Object) metodo .
Metodo UpdateStatistics(array di parametri statistici)
POS per .NET verifica che l'applicazione abbia aperto, richiesto e abilitato il dispositivo, quindi chiama il UpdateStatistics(Statistic[]) metodo .
Vedere anche
Reference
Concetti
Altre risorse
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
