Compartir a través de

Clase PosExplorer (documentación del SDK de POS para .NET versión 1.14)

PosExplorer proporciona aplicaciones de punto de servicio (POS) con un único punto de entrada para servicios de Microsoft Point of Service para .NET (POS para .NET). PosExplorer admite aplicaciones del siguiente modo:

  • Enumerando los dispositivos POS instalados
  • Creando instancias de los objetos de servicio
  • Recibiendo eventos Plug and Play cuando un dispositivo periférico POS se conecte o desconecte

Propiedades de PosExplorer

En la siguiente tabla se describen las propiedades de PosExplorer.

Propiedad Tipo Descripción
PosRegistryKey string Devuelve la clave del Registro de raíz de configuración de POS para .NET relativa a HKEY_LOCAL_MACHINE.
StatisticsFile string Devuelve una ruta de acceso al archivo donde están las estadísticas de dispositivo.
SynchronizingObject ISynchronizeInvoke Contiene el objeto ISynchronizeInvoke.

Métodos PosExplorer

En la siguiente tabla se describen los métodos de PosExplorer.

Método Tipo devuelto Descripción
CreateInstance PosDevice Crea una instancia de un objeto de servicio del dispositivo.
GetDevice DeviceInfo Devuelve un dispositivo del tipo especificado (solo puede haber uno en el sistema).
GetDevice DeviceInfo Devuelve un dispositivo del tipo con el alias o nombre lógico especificado.
getDevices DeviceCollection Devuelve todos los dispositivos POS.
getDevices DeviceCollection Devuelve todos los dispositivos POS con el nivel de compatibilidad especificado.
getDevices DeviceCollection Devuelve los dispositivos POS del tipo.
getDevices DeviceCollection Devuelve los dispositivos POS del tipo y el nivel de compatibilidad.
Actualizar Ninguno Vuelve a enumerar la lista de dispositivos POS conectados y vuelve a generar las estructuras de datos internas.

Eventos PosExplorer

En la siguiente tabla se describen los eventos de PosExplorer.

Evento Descripción
DeviceAddedEvent Se recibe cuando se conecta un dispositivo POS compatible con Plug and Play.
DeviceAddedEvent Se recibe cuando se desconecta un dispositivo POS compatible con Plug and Play.

Ejemplo

En el ejemplo de código siguiente se muestra cómo crear una instancia de PosExplorer, cómo conectarla a eventos Plug and Play y cómo usarla para identificar todos los dispositivos de lector de bandas magnéticas (MSR) conectados. En el ejemplo se imprime información sobre el dispositivo MSR en la consola y, una vez finalizado, el dispositivo se cierra.

// 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 también

Conceptos

Otros recursos

  • Last updated on