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

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

前 | 次 |

# EnqueueArray(OracleAQMessage[ ], OracleAQEnqueueOptions)

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

宣言

    // C#
    public int EnqueueArray(OracleAQMessage[] messages, OracleAQEnqueueOptions
      enqueueOptions);

パラメータ

- `messages`

  `OracleAQMessage`オブジェクトの配列。

- `enqueueOptions`

  `OracleAQEnqueueOptions`オブジェクト。

戻り値

実際にエンキューされたメッセージの数を表す`integer`。

例外

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

`ArgumentException` - 少なくとも1つの`OracleAQMessage[]`要素が`null`であるか、少なくとも1つの`OracleAQMessage[]`要素に`OracleXmlType`のペイロードがあります。このペイロードは、キューの接続とは異なる接続を使用して作成されます。

`InvalidOperationException` - `OracleAQMessage`配列が空か、接続がオープンされていません。

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

備考

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

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

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

関連項目:

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

- OracleAQQueueクラス

- OracleAQQueueメンバー