Sdílet prostřednictvím


PosExplorer – třída (POS pro .NET v1.14 SDK dokumentace)

PosExplorer poskytuje aplikace typu Point of Service (POS) s jediným vstupním bodem služby Microsoft Point of Service pro služby .NET (POS pro .NET). PosExplorer podporuje aplikace podle:

  • Výčet nainstalovaných zařízení POS
  • Vytváření instancí objektů služby
  • Příjem technologie Plug and Play událostí, když je periferní zařízení POS připojené nebo odpojené.

PosExplorer – vlastnosti

Následující tabulka popisuje vlastnosti PosExplorer .

Vlastnost Type Popis
PosRegistryKey string Vrátí POS pro kořenový klíč registru konfigurace .NET vzhledem k HKEY_LOCAL_MACHINE.
StatisticsFile string Vrátí cestu k souboru, kde jsou obsaženy statistiky zařízení.
Synchronizingobject ISynchronizeInvoke Obsahuje ISynchronizeInvoke objekt.

PosExplorer – metody

Následující tabulka popisuje metody PosExplorer .

Metoda Návratový typ Popis
CreateInstance PosDevice Vytvoří instanci objektu služby pro zařízení.
GetDevice Deviceinfo Vrátí zařízení zadaného typu (musí být v systému pouze jedno).
GetDevice Deviceinfo Vrátí zařízení typu se zadaným logickým názvem nebo aliasem.
GetDevices DeviceCollection Vrátí všechna zařízení POS.
GetDevices DeviceCollection Vrátí všechna zařízení POS se zadanou úrovní kompatibility.
GetDevices DeviceCollection Vrátí zařízení POS typu.
GetDevices DeviceCollection Vrátí zařízení POS typu a úrovně kompatibility.
Aktualizovat Nic Znovu vytvoří výčet seznamu připojených zařízení POS a znovu sestaví interní datové struktury.

Události PosExplorer

Následující tabulka popisuje události PosExplorer .

Událost Popis
DeviceAddedEvent Přijato při připojení technologie Plug and Play kompatibilního zařízení POS.
DeviceRemovedEvent Přijato při odpojení technologie Plug and Play kompatibilního zařízení POS.

Příklad

Následující příklad kódu ukazuje, jak vytvořit instanci PosExplorer, připojit se k technologie Plug and Play událostí a použít ho k identifikaci všech připojených zařízení MSR (Magnetic Stripe Reader). Příklad kódu vytiskne informace o MSR do konzoly a po dokončení zavře zařízení.

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

Viz také

Koncepty

Další prostředky