Udostępnij za pośrednictwem

Klasa PosExplorer (POS dla zestawu SDK platformy .NET w wersji 1.14)

PosExplorer Udostępnia aplikacje typu punkt usługi (POS) z pojedynczym punktem wejścia do usługi Microsoft Point of Service dla usług .NET (POS dla platformy .NET). Aplikacja PosExplorer obsługuje aplikacje przez:

  • Wyliczanie zainstalowanych urządzeń POS.
  • Tworzenie wystąpień obiektów usługi.
  • Odbieranie zdarzeń Plug and Play, gdy urządzenie peryferyjne poS jest podłączone lub odłączone.

Właściwości narzędzia PosExplorer

W poniższej tabeli opisano właściwości narzędzia PosExplorer .

Właściwość Type Opis
PosRegistryKey string Zwraca punkt zakupu dla klucza głównego rejestru konfiguracji platformy .NET względem HKEY_LOCAL_MACHINE.
StatisticsFile string Zwraca ścieżkę do pliku, w którym znajdują się statystyki urządzeń.
Synchronizingobject Isynchronizeinvoke Przechowuje obiekt ISynchronizeInvoke.

PosExplorer, metody

W poniższej tabeli opisano metody PosExplorer .

Metoda Zwracany typ opis
CreateInstance PosDevice Tworzy wystąpienie obiektu usługi dla urządzenia.
GetDevice Deviceinfo Zwraca urządzenie określonego typu (musi być tylko jedno w systemie).
GetDevice Deviceinfo Zwraca urządzenie typu o określonej nazwie logicznej lub aliasie.
GetDevices DeviceCollection Zwraca wszystkie urządzenia POS.
GetDevices DeviceCollection Zwraca wszystkie urządzenia poS z określonym poziomem zgodności.
GetDevices DeviceCollection Zwraca urządzenia poS typu.
GetDevices DeviceCollection Zwraca urządzenia poS typu i poziomu zgodności.
Odśwież Brak Ponownie wylicza listę dołączonych urządzeń POS i ponownie kompiluje wewnętrzne struktury danych.

Zdarzenia PosExplorer

W poniższej tabeli opisano zdarzenia PosExplorer .

Wydarzenie opis
DeviceAddedEvent Odebrano, gdy urządzenie poS zgodne ze standardem Plug and Play jest podłączone.
DeviceRemovedEvent Odebrano, gdy urządzenie poS zgodne ze standardem Plug and Play zostało rozłączone.

Przykład

W poniższym przykładzie kodu pokazano, jak utworzyć wystąpienie programu PosExplorer, nawiązać połączenie ze zdarzeniami Plug and Play i użyć go do identyfikowania wszystkich połączonych urządzeń czytnika paska magnetycznego (MSR). Przykładowy kod wyświetla informacje o msR do konsoli i zamyka urządzenie po zakończeniu.

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

Zobacz też

Pojęcia

Inne zasoby