Compartilhar via

Classe PosExplorer (Documentação do SDK do POS para .NET v1.14)

PosExplorer fornece aplicativos POS (Ponto de Serviço) com um único ponto de entrada para Microsoft Point of Service para .NET (POS para .NET). PosExplorer oferece suporte a aplicativos por:

  • Enumeração de dispositivos POS instalados.
  • Criação de instância de Objetos de Serviço.
  • Receber eventos Plug and Play quando um dispositivo periférico de POS estiver conectado ou desconectado.

Propriedades PosExplorer

A tabela a seguir descreve as propriedades PosExplorer:

Propriedade Type Descrição
PosRegistryKey string Retorna POS para a chave do Registro raiz de configuração do .NET em relação a HKEY_LOCAL_MACHINE.
StatisticsFile string Retorna um caminho para o arquivo em que as estatísticas do dispositivo estão contidas.
SynchronizingObject ISynchronizeInvoke Contém o objeto ISynchronizeInvoke.

Métodos PosExplorer

A tabela a seguir descreve os métodos PosExplorer:

Método Tipo de retorno Descrição
CreateInstance PosDevice Cria uma instância de um Objeto de Serviço para o dispositivo.
GetDevice DeviceInfo Retorna um dispositivo do tipo especificado (deve ser apenas um no sistema).
GetDevice DeviceInfo Retorna um dispositivo do tipo com o nome lógico ou alias especificado.
GetDevices DeviceCollection Retorna todos os dispositivos POS.
GetDevices DeviceCollection Retorna todos os dispositivos POS com o nível de compatibilidade especificado.
GetDevices DeviceCollection Retorna dispositivos POS do tipo.
GetDevices DeviceCollection Retorna dispositivos POS do tipo e do nível de compatibilidade.
Atualizar Nenhum Enumera novamente a lista de dispositivos POS anexados e recria estruturas de dados internas.

Eventos PosExplorer

A tabela a seguir descreve os eventos PosExplorer:

Evento Descrição
DeviceAddedEvent Recebido quando um dispositivo POS compatível com Plug and Play está conectado.
DeviceRemovedEvent Recebido quando um dispositivo POS compatível com Plug and Play está desconectado.

Exemplo

O exemplo de código a seguir demonstra como criar uma instância do PosExplorer, conectar-se a eventos Plug and Play e usá-la para identificar todos os dispositivos MSR (Leitor de Listras Magnéticas) conectados. O exemplo de código imprime informações sobre o MSR no console e fecha o dispositivo após a conclusão.

// Creates a new instance of an MSR.
void CreateMsr(DeviceInfo msrinfo)
{
    msr = (Msr)explorer.CreateInstance(msrinfo);
    msr.Open();
    msr.Claim(1000);
    msr.DeviceEnabled = true;
}

static void Main(string[] args)
{

    // Create a new instance of PosExplorer and use it to
    // collect device information.
    PosExplorer explorer = new PosExplorer();
    DeviceCollection devices = explorer.GetDevices();

    // Search all connected devices for an MSR, print its service
    // object name to the console, and close it when finished.
    foreach (DeviceInfo device in devices)
    {
      if (device.Type == DeviceType.Msr)
      {
         if (device.ServiceObjectName == currentMsr)
         {
            CreateMsr(device);
            Console.WriteLine(device.ServiceObjectName);

            // It is important that applications close all open
            // Service Objects before terminating.
            msr.Close();
            msr = null;
         }
      }
    }
}

Consulte Também

Conceitos

Outros recursos

  • Last updated on