Partilhar via


Propriedades de capacidade (documentação do SDK do PDV para .NET v1.14)

Certas propriedades não podem ser definidas diretamente em um objeto de serviço. Isso aparece com mais frequência no caso de propriedades de capacidade; aqueles com o prefixo Cap em seus nomes. De acordo com a especificação UnifiedPOS (Unified Point Of Service), essas propriedades devem ser somente leitura; portanto, um mecanismo específico de implementação é necessário para que o objeto de serviço altere o valor dessas propriedades.

Propriedades BaseClass

As classes Base do Microsoft Point of Service for .NET (POS for .NET) têm uma propriedade protegida, Properties, para esta finalidade. 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 recursos específicas do PinPad, como CapDisplay.

PosCommon Propriedades

Além das classes de propriedade específicas do dispositivo, todas as classes POS para .NET Base e Basic 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 capacidade e status encontradas em PosCommon.

Definindo propriedades usando classes auxiliares

Em geral, um objeto de serviço deve sempre acessar o valor de suas propriedades comuns e específicas de 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 PDV para .NET framework pode fazer quando um determinado valor é alterado. Por exemplo, o objeto de serviço geralmente não deve alterar CommonProperties.State , pois isso pode interferir com o estado interno do PDV para .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.

Nota

Ao derivar do POS para .NET Base ou classes Basic, o objeto de serviço geralmente não deve alterar o valor de CommonProperties.State para ControlState.Closed. Isso impede a limpeza da fila de eventos, e o POS para .NET pode lançar exceções mais tarde enquanto tenta processar eventos que já estão na fila.

Consulte também