Partilhar via

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

PosExplorer fornece aplicativos de ponto de serviço (POS) com um único ponto de entrada para serviços Microsoft Point of Service for .NET (POS para .NET). PosExplorer suporta aplicações por:

  • Enumerando dispositivos POS instalados.
  • Instanciando objetos de serviço.
  • Receber eventos Plug and Play quando um dispositivo periférico POS está ligado ou desligado.

Propriedades PosExplorer

A tabela a seguir descreve as propriedades do PosExplorer .

Propriedade Type Description
PosRegistryKey string Retorna a chave do Registro raiz de configuração do PDV para .NET em relação ao HKEY_LOCAL_MACHINE.
Ficheiro de Estatísticas string Retorna um caminho para o arquivo onde as estatísticas do dispositivo estão contidas.
SynchronizingObject ISynchronizeInvoke Mantém o objeto ISynchronizeInvoke.

Métodos PosExplorer

A tabela a seguir descreve os métodos PosExplorer .

Método Tipo de Retorno Description
CreateInstance PosDevice Instancia 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 nível de compatibilidade.
Atualizar Nenhuma Reenumera a lista de dispositivos POS anexados e reconstrói estruturas de dados internas.

Eventos PosExplorer

A tabela a seguir descreve eventos PosExplorer .

Evento Descrição
DeviceAddedEvent Recebido quando um dispositivo POS compatível com Plug and Play está ligado.
DeviceRemovedEvent Recebido quando um dispositivo POS compatível com Plug and Play é 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á-lo para identificar todos os dispositivos MSR (Magnetic Stripe Reader) conectados. O exemplo de código imprime informações sobre o MSR no console e fecha o dispositivo depois que ele terminar.

// 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