EnqueueArray(OracleAQMessage[ ])

このインスタンス・メソッドは、インスタンスのEnqueueOptionsを使用してキューに複数のメッセージをエンキューします。

宣言

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

パラメータ

messages

OracleAQMessageオブジェクトの配列。

戻り値

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

例外

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

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

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

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

備考

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

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