プライマリ・コンテンツに移動

Oracle® Data Provider for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88311-03 |
| 目次 | 索引

前 | 次 |

# Enqueue(OracleAQMessage, OracleAQEnqueueOptions)

このインスタンス・メソッドは、指定されたエンキュー・オプションを使用してキューにメッセージをエンキューします。

宣言

    // C#
    public void Enqueue(OracleAQMessage message, OracleAQEnqueueOptions enqueueOptions);

パラメータ

- `message`

  `OracleAQMessage`オブジェクト。

- `enqueueOptions`

  `OracleAQEnqueueOptions`オブジェクト。

例外

`ObjectDisposedException` - オブジェクトはすでに処理されています。

`InvalidOperationException` - 接続がオープンされていません。

`ArgumentNullException` - メッセージ・パラメータが`null`です。

`ArgumentException` - メッセージ・ペイロードは`OracleXmlType`で、`OracleXmlType`の作成に使用される接続はキューの接続とは異なります。

備考

指定した`enqueueOptions`オブジェクトが`null`の場合は、エンキュー・オプションのデフォルト値が使用されます。この操作では、キュー・オブジェクトの`EnqueueOptions`プロパティは無視されます。

`Enqueue`のコールが完了すると、エンキューされたメッセージの`MessageId`に値が移入されます。エンキューされたバッファ・メッセージは、常に`nullのMessageId`値を持ちます。このメソッドをコールしても、キューの`EnqueueOptions`プロパティは変更されません。

このファンクションをコールする前に`MessageType`プロパティを適切に設定しておく必要があります。`MessageType`が`OracleAQMessageType.UDT`の場合は、`UdtTypeName`プロパティも設定する必要があります。

関連項目:

- Oracle.DataAccess.ClientおよびOracle.ManagedDataAccess.Clientのネームスペース

- OracleAQQueueクラス

- OracleAQQueueメンバー