Compartir a través de

Propiedades de funcionalidad (documentación del SDK de POS para .NET versión 1.14)

Algunas propiedades no se pueden establecer directamente dentro de un objeto de servicio. Esto aparece con más frecuencia en el caso de las propiedades de funcionalidad; aquellas con el prefijo Cap en sus nombres. Según la especificación de Unified Point Of Service (UnifiedPOS), estas propiedades deben ser de solo lectura; por lo tanto, se necesita un mecanismo específico de la implementación para que el objeto de servicio cambie el valor de estas propiedades.

Propiedades de BaseClass

Las clases Base de Microsoft Point of Service for .NET (POS for .NET) tienen una propiedad protegida, Properties, con este fin. Esta propiedad devuelve una clase auxiliar que tiene versiones grabables de las propiedades de solo lectura implementadas en la clase Base. Por ejemplo, PinPadBase tiene una propiedad denominada Properties que devuelve un objeto de tipo PinPadProperties. Y este objeto contiene propiedades usadas para establecer varias propiedades de funcionalidad específicas de PinPad, como CapDisplay.

Propiedades de PosCommon

Además de las clases de propiedad específicas del dispositivo, todas las clases POS para .NET Base y Basic también tienen una propiedad protegida denominada CommonProperties, que devuelve un objeto de tipo CommonProperties. Esta clase auxiliar se usa para modificar las propiedades de funcionalidad y estado que se encuentran en PosCommon.

Establecer propiedades mediante clases auxiliares

En general, un objeto de servicio siempre debe tener acceso al valor de sus propiedades comunes y específicas de clase mediante las clases auxiliares. El objeto de servicio puede escribir estas propiedades y siempre contener los valores adecuados.

El desarrollador de objetos de servicio debe tener en cuenta lo que puede hacer el POS para .NET Framework cuando se cambia un valor determinado. Por ejemplo, el objeto de servicio generalmente no debe cambiar CommonProperties.State, ya que esto puede interferir con el POS para el estado interno de .NET. Del mismo modo, el desarrollador de objetos de servicio debe tener en cuenta que cambiar CommonProperties.PowerState puede enviar un evento StatusUpdateEvent a la aplicación.

Nota

Al derivar de las clases POS para .NET Base o Basic, el objeto de servicio generalmente no debe cambiar el valor de CommonProperties.State a ControlState.Closed. De este modo, se evita la limpieza de la cola de eventos y POS para .NET puede iniciar excepciones más adelante, ya que intenta procesar eventos ya en la cola.

Consulte también

  • Last updated on