Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En la base del árbol de clases de la clase de objetos del servidor POS para .NET (Interface, Basic, Base) se encuentra PosCommon. Esta clase es una implementación directa del capítulo "Propiedades comunes, métodos y eventos" de la especificación UPOS.
Cada POS para la clase básica de .NET invalida o implementa propiedades y métodos PosCommon que son de especial importancia para un desarrollador de objetos de servicio. En este tema se proporciona información sobre estos métodos y propiedades.
CapPowerReporting (propiedad)
Una vez que pos para .NET ha abierto correctamente un dispositivo, intenta recuperar el valor actual de la CapPowerReporting propiedad. La PowerReporting clase se inicializa en None, lo que indica que el objeto de servicio no puede proporcionar informes de energía. Sin embargo, si el dispositivo del objeto de servicio admite informes de energía, el objeto de servicio puede establecer PowerReporting en Estándar o Avanzado en el método del objeto de servicio.
Propiedad CapStatisticsReporting
POS para .NET comprueba que el dispositivo se ha abierto y, a continuación, recupera el valor actual de la CapStatisticsReporting propiedad.
Cuando se crean estadísticas para el dispositivo, POS para .NET establece CapStatisticsReporting en true.
Propiedad CapUpdateStatistics
POS para .NET comprueba que el dispositivo se ha abierto y, a continuación, recupera el valor actual de la CapUpdateStatistics propiedad.
Cuando se crean estadísticas para el dispositivo y, si esas estadísticas se pueden restablecer o actualizar, POS para .NET establece CapUpdateStatistics en true.
Propiedad Reclamada
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la Claimed propiedad.
Claimed se inicializa a falso. Debe establecerse en true cuando la aplicación llama al Claim(Int32) método, y luego debe restablecerse en false cuando la aplicación llama al Release() método.
DeviceDescription (propiedad)
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la DeviceDescription propiedad.
La propiedad DeviceEnabled
DeviceEnabled es una propiedad de lectura y escritura.
Se puede usar para devolver el estado actual del objeto; habilitado o deshabilitado. Si este objeto no se ha abierto previamente y habilitado, esta propiedad devuelve false.
Esta propiedad también se usa para habilitar o deshabilitar el dispositivo estableciendo la propiedad del valor en true o false. Es habitual que los objetos de servicio invaliden esta propiedad y realicen su inicialización de hardware y su lanzamiento aquí.
Propiedad DeviceName
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la DeviceName propiedad.
Dentro de las implementaciones de clase Base , este valor se establece automáticamente en función del contenido del ServiceObject atributo.
Si no deriva de un POS para la clase Base de .NET y, en su lugar, deriva de una clase de nivel de interfaz o de nivel básico, DeviceName debe establecerse mediante el objeto de servicio durante el Open() método.
Propiedad FreezeEvents
FreezeEvents es una propiedad de lectura y escritura.
POS para .NET comprueba que el dispositivo se ha abierto y reclamado y, a continuación, recupera o establece el valor actual de la propiedad FreezeEvents . Cuando esta propiedad se establece en true, POS para .NET almacena eventos en cola hasta que esta propiedad se establezca en false, sin que el mecanismo de puesta en cola pueda variar de un tipo de dispositivo a otro.
La propiedad FreezeEvents se inicializa en false.
PowerNotify (propiedad)
PowerNotify es una propiedad de lectura y escritura.
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera o establece el valor actual de PowerNotify. Si se establece PowerNotify , las notificaciones de estado de energía se enviarán a la aplicación.
PowerNotify se inicializa en Deshabilitado.
Si intenta establecer PowerNotify, podrían producirse las siguientes excepciones.
| Valor | significado |
|---|---|
Illegal |
Se ha producido una de las condiciones siguientes:
|
Propiedad PowerState
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la PowerState propiedad. Si CapPowerReporting está establecido en Ninguno, PowerNotify se establece en Disabled o DeviceEnabled establecido en false, PowerState se devuelve como Unknown.
PowerState se inicializa en Desconocido. Cuando PowerNotify se establece en Habilitado y DeviceEnabled es true, PowerState debe actualizarse a medida que el objeto de servicio detecta cambios en la condición de energía. POS para .NET detecta el cambio de estado cuando el objeto de servicio establece PowerState y, si PowerNotify está establecido en Habilitado, pone en cola un StatusUpdateEvent evento y notifica a la aplicación.
La configuración PowerState puede provocar que se produzcan las siguientes excepciones.
| Valor | significado |
|---|---|
Illegal |
Se ha producido una de las condiciones siguientes:
|
Propiedad de Descripción del Objeto de Servicio
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la ServiceObjectDescription propiedad. El desarrollador de objetos de servicio no debe tener que establecer este valor, ya que la clase POS para .NET Basic establece mediante la información de descripción proporcionada en el ServiceObject atributo .
Propiedad ServicioObjetoVersión
POS para .NET comprueba que se ha abierto el dispositivo y, a continuación, recupera el valor actual de la ServiceObjectVersion propiedad. El desarrollador de objetos de servicio no debe tener que establecer este valor, ya que lo establece el POS para la clase .NET Basic mediante la información de versión proporcionada en el ServiceObject atributo .
State (propiedad)
No se requiere ninguna comprobación del estado del dispositivo: la aplicación puede recuperar el valor actual del State property.at en cualquier momento.
El estado se inicializa en Cerrado. Si el objeto de servicio establece El estado en un valor no válido ControlState , POS para .NET produce una excepción no válida. Los cambios en State hacen que POS para .NET coloque en cola un evento StateChangedEvent.
Método de reclamación
POS para .NET comprueba que la aplicación tiene abierto el dispositivo.
Si el parámetro de tiempo de espera se establece en un valor menor que -1, POS para .NET produce una excepción. Si el valor de tiempo de espera se establece en -1, el método Claim esperará para siempre.
Si la aplicación ya ha reclamado el dispositivo, POS para .NET simplemente devuelve.
Si el dispositivo está en uso por otra aplicación, se alcanza el tiempo de espera y POS para .NET lanza una excepción de tiempo de espera.
Si Claim se realiza correctamente, POS para .NET carga las estadísticas del dispositivo y establece la propiedad Claimed en true.
Close (Método)
Si la aplicación llama al Close() método cuando State está establecido en Closed, POS para .NET produce una excepción Closed . Si State está establecido en Ocupado, POS para .NET produce una excepción Busy .
Si se establece Claimed en false cuando el método DeviceEnabled está activo, POS para .NET lanza una excepción ilegal. Si State está establecido en Ocupado, POS para .NET llama al método ClearOutput . Si el dispositivo está habilitado, POS para .NET establece DeviceEnabled a false. POS para .NET borra la cola de eventos y, a continuación, establece Reclamado en false.
Método ResetStatistic
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método ResetStatistic(String).
ResetStatistics() (método)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método ResetStatistics().
Método ResetStatistics(parámetro de categorías)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método ResetStatistics(StatisticCategories).
Método ResetStatistics(string parameter)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método ResetStatistics(String[]).
Método RetrieveStatistic
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método RetrieveStatistic(String).
Método RetrieveStatistics()
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método RetrieveStatistics().
Método RetrieveStatistics(categories parameter)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método RetrieveStatistics(StatisticCategories).
Método RetrieveStatistics(string parameter)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método RetrieveStatistics(String[]).
Método UpdateStatistic
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método UpdateStatistic(String, Object).
Método UpdateStatistics(parámetro de categorías)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método UpdateStatistics(StatisticCategories, Object).
Método UpdateStatistics(parámetro de matriz estadística)
POS para .NET comprueba que la aplicación ha abierto, reclamado y habilitado el dispositivo y luego llama al método UpdateStatistics(Statistic[]).
Véase también
Referencia
Conceptos
Otros recursos
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
