Compartilhar via

Propriedades de funcionalidade (POS para documentação do SDK do .NET v1.14)

Determinadas propriedades não podem ser definidas diretamente em um Objeto de Serviço. Isso aparece com mais frequência no caso de propriedades de funcionalidade; aqueles com o prefixo Cap em seus nomes. De acordo com a especificação UnifiedPOS (ponto de serviço unificado), essas propriedades devem ser somente leitura. Portanto, um mecanismo específico da implementação é necessário para que o Objeto de Serviço altere o valor dessas propriedades.

Propriedades BaseClass

As classes Base do POS para .NET (Ponto de Serviço da Microsoft para .NET) têm uma propriedade protegida, Properties, para este objetivo. Essa propriedade retorna uma classe auxiliar que tem versões graváveis das propriedades somente leitura implementadas na classe Base. Por exemplo, PinPadBase tem uma propriedade chamada Properties que retorna um objeto do tipo PinPadProperties. E esse objeto contém propriedades usadas para definir várias propriedades de funcionalidade específicas do PinPad, como CapDisplay.

Propriedades PosCommon

Além das classes de propriedade específicas do dispositivo, todos os POS para as classes Base e Basic do .NET também têm uma propriedade protegida chamada CommonProperties, que retorna um objeto do tipo CommonProperties. Essa classe auxiliar é usada para modificar as propriedades de funcionalidade e status encontradas no PosCommon.

Definir propriedades usando classes auxiliares

Em geral, um Objeto de Serviço sempre deve acessar o valor de suas propriedades comuns e específicas da classe usando as classes auxiliares. Essas propriedades podem ser gravadas pelo Objeto de Serviço e sempre contêm os valores apropriados.

O desenvolvedor do Objeto de Serviço deve estar ciente do que o POS para .NET Framework pode fazer quando um valor específico é alterado. Por exemplo, o Objeto de Serviço geralmente não deve alterar CommonProperties.State, pois isso pode interferir no POS para o estado interno do .NET. Da mesma forma, o desenvolvedor do Objeto de Serviço deve estar ciente de que alterar CommonProperties.PowerState pode enviar um evento StatusUpdateEvent para o aplicativo.

Observação

Ao derivar do POS para classes Base ou Basic do .NET, o Objeto de Serviço geralmente não deverá alterar o valor de CommonProperties.State para ControlState.Closed. Isso impede a limpeza da fila de eventos, e o POS para .NET pode gerar exceções posteriormente, pois tenta processar eventos que já estão na fila.

Confira também

  • Last updated on