12.7.5.2 Dequeue()
このインスタンス・メソッドは、インスタンスのDequeueOptions
を使用してキューからメッセージをデキューするために使用します。
宣言
// C# public OracleAQMessage Dequeue();
戻り値
デキューされたメッセージを表すOracleAQMessage
インスタンス。
例外
InvalidOperationException
- 接続がオープンされていません。
ObjectDisposedException
- オブジェクトはすでに処理されています。
OracleException
: タイムアウトした場合、「ORA-25228: queue_nameからメッセージをデキュー中に、タイムアウトまたはフェッチ終了になりました。」
というメッセージとともに例外がスローされます。DequeueOptions.Wait
が-1
以外の値に設定されていると、タイムアウトが発生することがあります。
備考
このファンクションをコールする前にMessageType
プロパティを適切に設定しておく必要があります。MessageType
がOracleAQMessageType.UDT
の場合は、UdtTypeName
プロパティも設定する必要があります。
デキューされたバッファ・メッセージのMessageId
値は常にnull
です。