12.2.3.8 Visibility
このインスタンス・プロパティは、新規メッセージを現行トランザクションの一部としてデキューするかどうかを指定します。
宣言
// C# public OracleAQVisibilityMode Visibility {get;set;}
プロパティ値
OracleAQVisibilityMode
の列挙値。
例外
ArgumentOutOfRangeException
- 指定したVisibility
値が無効です。
備考
デフォルト値はOracleAQVisibilityMode.OnCommit
です。このプロパティのデフォルト値を使用する場合、トランザクションを使用する必要があります。これにより、アプリケーションでメッセージが失われることがなくなり、メッセージはデキュー操作が正常に完了してから適切にキューから削除されます。デフォルトの可視性モードOracleAQVisibilityMode.OnCommit
を使用する際にトランザクションを使用しない場合、メッセージはキューから削除されません。
別の可視性モードの値OracleAQVisibilityMode.Immediate
を使用する場合、トランザクションの作成、コミットおよびロールバックは不要になります。ただし、デキュー操作中にエラーが発生した場合、メッセージが失われる可能性があります。
DequeueMode
がOracleAQDequeueMode.Browse
に設定されている場合、可視性パラメータは無視されます。