共用方式為

PosExplorer 類別 (POS for .NET 1.14 版 SDK 文件)

  • 發行項

PosExplorer 提供適用於 .NET 之 Microsoft 服務點 (POS for .NET) 的單一進入點服務點 (POS) 應用程式。 PosExplorer 透過下列方式支援應用程式：

  • 列舉已安裝的 POS 裝置。
  • 具現化服務物件。
  • 在 POS 周邊裝置連線或中斷連線時接收隨插即用事件。

PosExplorer 屬性

下表說明 PosExplorer 屬性。

屬性 類型​ 描述
PosRegistryKey string 傳回相對於 HKEY_LOCAL_MACHINE POS for .NET 設定根登錄機碼。
StatisticsFile string 傳回包含裝置統計資料之檔案的路徑。
SynchronizingObject ISynchronizeInvoke 保存 ISynchronizeInvoke 物件。

PosExplorer 方法

下表說明 PosExplorer 方法。

方法 傳回類型 描述
CreateInstance PosDevice 具現化裝置的服務物件。
GetDevice DeviceInfo 傳回指定型別的裝置 (必須是系統中的裝置)。
GetDevice DeviceInfo 傳回具有指定邏輯名稱或別名之型別的裝置。
GetDevices DeviceCollection 傳回所有 POS 裝置。
GetDevices DeviceCollection 傳回具有指定相容性層級的所有 POS 裝置。
GetDevices DeviceCollection 傳回型別的 POS 裝置。
GetDevices DeviceCollection 傳回型別和相容性層級的 POS 裝置。
Refresh 無 重新列舉連接的 POS 裝置清單，並重建內部資料結構。

PosExplorer 事件

下表說明 PosExplorer 事件。

事件 描述
DeviceAddedEvent 連接隨插即用相容 POS 裝置時接收。
DeviceRemovedEvent 中斷連線隨插即用相容 POS 裝置時接收。

範例

下列程式碼範例示範如何建立 PosExplorer 的執行個體、連線到隨插即用事件，並使用其來識別所有連接的磁條讀取器 (MSR) 裝置。 此程式碼範例會將 MSR 的相關資訊列印到主控台，並在完成之後關閉裝置。

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

另請參閱

概念

其他資源