建立基本服務物件代碼範本 (POS for .NET v1.14 SDK 文件)
上一節設定服務物件專案說明如何建立空白專案以開始撰寫您的服務物件。 本節會繼續將功能新增至該範例專案。 本主題中的下列程式和範例會顯示建立基本服務物件範本時必須遵循的步驟。
建立簡單的類別範本
將 Microsoft.PointOfService 和 Microsoft.PointOfService.BaseServiceObjects 的 using 指示詞新增至原始程式檔頂端。
選擇您的服務物件將衍生自哪一項 POS for .NET Base 類別。 您選擇的 Base 類別是以您要開發此服務物件的 POS 裝置類型為基礎。 (請參閱POS for .NET 類別樹狀結構)
如果您要在 Point of Service 基本類別上建置類別,請同時新增 Microsoft.PointOfService.BasicServiceObjects 的 using 指示詞。
將 ServiceObject 屬性套用至 Service Object 類別。 這包括下列元素:
- 裝置類型
- 服務物件名稱
- 服務物件的描述
- 主要版本
- 次要版本
建立預設的公用無參數建構函式。 這是 PosExplorer 使用 .NET 反映建立類別執行個體的必要項目。
範例
在此範例中,請注意其他 using 指示詞、套用至服務物件類別的 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 服務物件 Base 類別,其必須實作的抽象方法清單不同。 下列各節會繼續將功能新增至範例,直到成為完整的功能服務物件實作為止。