Partager via

Classe PosExplorer (documentation du kit SDK POS pour .NET v1.14)

PosExplorerfournit des applications POS (Point of Service) avec un point d’entrée unique pour Microsoft Point of Service pour les services .NET (POS pour .NET). PosExplorer prend en charge les applications en :

  • énumérant les appareils POS installés.
  • instanciant des objets de service.
  • recevant des événements Plug-and-Play lorsqu’un périphérique POS est connecté ou déconnecté.

Propriétés PosExplorer

Le tableau suivant décrit les propriétés PosExplorer.

Propriété Type Description
PosRegistryKey string Retourne la clé de Registre racine de configuration POS pour .NET relative à HKEY_LOCAL_MACHINE.
StatisticsFile string Retourne un chemin d’accès au fichier dans lequel les statistiques d’appareil sont contenues.
SynchronizingObject ISynchronizeInvoke Contient l’objet ISynchronizeInvoke.

Méthodes PosExplorer

Le tableau suivant décrit les méthodes PosExplorer.

Méthode Type renvoyé Description
CreateInstance PosDevice Instancie un objet de service pour l’appareil.
GetDevice DeviceInfo Retourne un appareil du type spécifié (ne doit être qu’un appareil dans le système).
GetDevice DeviceInfo Retourne un appareil du type avec le nom logique ou l’alias spécifié.
GetDevices DeviceCollection Retourne tous les appareils POS.
GetDevices DeviceCollection Retourne tous les appareils POS avec le niveau de compatibilité spécifié.
GetDevices DeviceCollection Retourne des appareils POS du type.
GetDevices DeviceCollection Retourne les appareils POS du type et du niveau de compatibilité.
Actualiser None Énumère à nouveau la liste des appareils POS attachés et régénère les structures de données internes.

Événements PosExplorer

Le tableau suivant décrit les événements PosExplorer.

Événement Description
DeviceAddedEvent Reçu lorsqu’un appareil POS compatible Plug-and-Play est connecté.
DeviceRemovedEvent Reçu lorsqu’un appareil POS compatible Plug-and-Play est déconnecté.

Exemple

L’exemple de code suivant montre comment créer une instance de PosExplorer, se connecter à des événements Plug-and-Play et l’utiliser pour identifier tous les appareils MSR (Magnetic Stripe Reader) connectés. L’exemple de code imprime des informations sur le MSR dans la console et ferme l’appareil une fois qu’il a terminé.

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

Voir aussi

Concepts

Autres ressources

  • Last updated on