前一節「 設定服務物件專案」解釋了如何建立一個空專案來開始撰寫服務物件。 本節接著為該範例專案增添功能。 以下程序及本主題範例展示了建立基本服務物件範本所需遵循的步驟。
建立一個簡單的類別範本
將 using 指令新增至原始檔案頂端以便使用Microsoft.PointOfService 和Microsoft.PointOfService.BaseServiceObjects。
選擇 .NET 基底 類別的 POS 來推導你的服務物件。 你選擇 的基底 類別是根據你開發此服務物件所使用的 POS 裝置類型而定。 (請參見 POS 以了解 .NET 類別樹)
如果你是在服務點 Basic 類別之上建置類別,也要為 Microsoft.PointOfService.BasicServiceObjects 新增 using 指令。
對你的服務物件類別套用屬性
ServiceObject。 這包括以下要素:- 裝置類型
- 服務物件名稱
- 服務物件的描述
- 主要版本
- 次要版本
建立一個預設的公開無參數建構子。 這是 PosExplorer 使用 .NET 反射來建立你類別實例所必須的。
Example
在此範例中,請注意額外的 使用 指令、 ServiceObject 套用於服務物件類別的屬性、用於服務物件類別的 基底 類別,以及最後無參數的公開建構器。
using system;
using Microsoft.PointOfService;
using Microsoft.PointOfService.BaseServiceObjects;
namespace Samples.ServiceObjects.SOTemplate
{
[ServiceObject(
DeviceType.Msr,
"ServiceObjectTemplate",
"Bare bones Service Object class",
1,
9)]
public class MyServiceObject : MsrBase
{
public MyServiceObject()
{
}
}
}
此範例無法按目前狀態編譯。 其目的是展示任何服務物件類別所需的元素。 然而,對於每個 POS for .NET 服務物件 庫 類別,必須實作的抽象方法清單各不相同。 接下來的章節持續為範例新增功能,直到它成為完整且功能完整的服務物件實作。