POS for .NET Server Object クラス ツリーのベース (インターフェイス、 基本、 基本) が PosCommon。 このクラスは、UPOS 仕様の「共通プロパティ、メソッド、およびイベント」の章を直接実装したものです。
.NET Basic クラスの各 POS は、サービス オブジェクト開発者にとって特に重要な PosCommon プロパティとメソッドをオーバーライドまたは実装します。 このトピックでは、これらのメソッドとプロパティについて説明します。
CapPowerReporting プロパティ
POS for .NET は、デバイスを正常に開くと、 CapPowerReporting プロパティの現在の値の取得を試みます。 PowerReporting クラスは None に初期化され、サービス オブジェクトが電源レポートを提供できないことを示します。 ただし、サービス オブジェクトのデバイスが電源レポートをサポートしている場合、サービス オブジェクトは、サービス オブジェクトのメソッドで PowerReporting を Standard または Advanced に設定できます。
CapStatisticsReporting プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 CapStatisticsReporting プロパティの現在の値を取得します。
デバイスの統計が作成されると、.NET の POS によって CapStatisticsReporting が true に設定 されます。
CapUpdateStatistics プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 CapUpdateStatistics プロパティの現在の値を取得します。
デバイスの統計が作成され、それらの統計情報をリセットまたは更新できる場合は、.NET の POS によって CapUpdateStatistics が true に設定されます。
主張されたプロパティ
POS for .NET は、デバイスが開かれていることを確認し、 Claimed プロパティの現在の値を取得します。
Claimedはfalseに初期化されます。 要求は、アプリケーションが メソッドを呼び出すときに Claim(Int32) に設定し、アプリケーションが メソッドを呼び出すときに Release() に戻す必要があります。
DeviceDescription プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 DeviceDescription プロパティの現在の値を取得します。
DeviceEnabled プロパティ
DeviceEnabled は読み取り/書き込みプロパティです。
オブジェクトの現在の状態を返すために使用できます。有効または無効。 このオブジェクトが以前に開いて有効になっていない場合、このプロパティは false を返 します。
このプロパティは、値のプロパティを true または false に設定して、デバイスを有効または無効にするためにも使用 されます。 サービス オブジェクトでは、このプロパティをオーバーライドし、ここでハードウェアの初期化とリリースを実行するのが一般的です。
DeviceName プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 DeviceName プロパティの現在の値を取得します。
基底クラスの実装内では、この値はServiceObject属性の内容に基づいて自動的に設定されます。
.NET 基本クラスの POS から派生せず、代わりにインターフェイス レベルまたは Basic レベルのクラスから派生している場合は、 メソッドの間に Service Subject によって Open() を設定する必要があります。
FreezeEvents プロパティ
FreezeEvents は読み取り/書き込みプロパティです。
POS for .NET は、デバイスが開いて要求されたことを確認し、 FreezeEvents プロパティの現在の値を取得または設定します。 このプロパティが true に設定されている場合、.NET の POS は、このプロパティが false に設定されるまでイベントをキューに入れます。キュー メカニズムがデバイスの種類によって異なる場合はありません。
FreezeEvents プロパティは false に初期化されます。
PowerNotify プロパティ
PowerNotify は読み取り/書き込みプロパティです。
POS for .NET は、デバイスが開かれていることを確認し、 PowerNotify の現在の値を取得または設定します。 PowerNotify が設定されている場合、電源状態通知がアプリケーションに送信されます。
PowerNotify は Disabled に初期化されます。
PowerNotify を設定しようとすると、次の例外がスローされる可能性があります。
| 価値 | 意味 |
|---|---|
Illegal |
次のいずれかの条件が発生しました。
|
PowerState プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 PowerState プロパティの現在の値を取得します。 CapPowerReporting が None に設定されている場合、PowerNotify が無効に設定されているか、DeviceEnabled が false に設定されている場合、PowerState は Unknown として返されます。
PowerState は Unknown に初期化されます。 PowerNotify が Enabled に設定され、DeviceEnabled が true の場合、サービス オブジェクトが電源状態の変化を検出したら、PowerState を更新する必要があります。 POS for .NET は、サービス オブジェクトが PowerState を設定したときに状態の変化を検出し、 PowerNotify が 有効に設定されている場合は、 StatusUpdateEvent イベントをキューに入れ、アプリケーションに通知します。
PowerStateを設定すると、次の例外がスローされる可能性があります。
| 価値 | 意味 |
|---|---|
Illegal |
次のいずれかの条件が発生しました。
|
ServiceObjectDescription プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 ServiceObjectDescription プロパティの現在の値を取得します。 サービス オブジェクト開発者は、この値を設定する必要はありません。これは、属性で提供される説明情報を使用して.NET ServiceObject クラスの POS によって設定されるためです。
ServiceObjectVersion プロパティ
POS for .NET は、デバイスが開かれていることを確認し、 ServiceObjectVersion プロパティの現在の値を取得します。 サービス オブジェクト開発者は、この値を設定する必要はありません。これは、属性で提供されるバージョン情報を使用して.NET ServiceObject クラスの POS によって設定されるためです。
State プロパティ
デバイス状態の検証は必要ありません。アプリケーションはいつでも State property.at の現在の値を取得できます。
状態 は Closed に初期化 されます。 サービス オブジェクトが State を無効な ControlState 値に設定すると、.NET の POS は無効な例外をスローします。 状態の変更により、.NET の POS が StateChangedEvent イベントをキューに入れます。
Claim メソッド
POS for .NET は、アプリケーションでデバイスが開かれていることを確認します。
タイムアウト パラメーターが -1 未満の値に設定されている場合、.NET の POS は例外をスローします。 タイムアウト値が -1 に設定されている場合、Claim メソッドは永久に待機します。
デバイスがアプリケーションによって既に登録済みの場合、POS for .NET は単にそのまま終了します。
デバイスが別のアプリケーションで使用されている場合、タイムアウトに達すると、.NET 用 POS はタイムアウト例外をスローします。
要求が成功した場合、.NET の POS はデバイスの統計情報を読み込み、要求されたプロパティを true に設定します。
Close メソッド
Close() が Closed に設定されているときにアプリケーションが メソッドを呼び出すと、.NET の POS は Closed 例外をスローします。 State が Busy に設定されている場合、.NET の POS はビジー例外をスローします。
要求時に DeviceEnabled メソッドが false に設定されている場合、.NET の POS は無効な例外をスローします。 State が Busy に設定されている場合、.NET の POS は ClearOutput メソッドを呼び出します。 デバイスが有効になっている場合、.NET の POS は DeviceEnabled を false に設定します。 .NET 用 POS はイベント キューをクリアし、 Claimed を false に設定 します。
ResetStatistic メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 ResetStatistic(String) メソッドを呼び出します。
ResetStatistics() メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 ResetStatistics() メソッドを呼び出します。
統計リセット（カテゴリーパラメーター）メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 ResetStatistics(StatisticCategories) メソッドを呼び出します。
ResetStatistics(文字列パラメーター) メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 ResetStatistics(String[]) メソッドを呼び出します。
RetrieveStatistic メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 RetrieveStatistic(String) メソッドを呼び出します。
RetrieveStatistics() メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 RetrieveStatistics() メソッドを呼び出します。
RetrieveStatistics(カテゴリパラメーター) メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 RetrieveStatistics(StatisticCategories) メソッドを呼び出します。
RetrieveStatistics(string parameter) メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 RetrieveStatistics(String[]) メソッドを呼び出します。
UpdateStatistic メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 UpdateStatistic(String, Object) メソッドを呼び出します。
統計情報を更新する (カテゴリー パラメーター) メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 UpdateStatistics(StatisticCategories, Object) メソッドを呼び出します。
UpdateStatistics(統計配列パラメーター) メソッド
POS for .NET は、アプリケーションがデバイスを開き、要求し、有効にしたことを確認してから、 UpdateStatistics(Statistic[]) メソッドを呼び出します。
こちらもご覧ください
リファレンス
概念
その他のリソース
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET