| Oracle® Data Provider for .NET開発者ガイド 11g リリース2 (11.2.0.4) B66456-02 |
|
 前 |
 次 |
OracleAQAgentクラスは、メッセージの送信者または受信者となるエージェントを表します。
クラスの継承
System.Object
OracleAQAgent
宣言
// C# public sealed class OracleAQAgent
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
備考
エージェントは、コンシューマ、別のキュー、別のキューのコンシューマのいずれかです。キューは、ローカルまたはリモートです。リモート・キューは、データベース・リンクを通じて指定します。
要件
ネームスペース: Oracle.DataAccess.Client
アセンブリ: Oracle.DataAccess.dll
ODP.NETのバージョン: ODP.NET for .NET Framework 2.0またはODP.NET for .NET Framework 4
OracleAQAgentメンバーを、次の各表に示します。
OracleAQAgentコンストラクタ
OracleAQAgentコンストラクタを、表12-1にリストします。
OracleAQAgentプロパティ
OracleAQAgentプロパティを、表12-2にリストします。
OracleAQAgentコンストラクタは、OracleAQAgentクラスの新規インスタンスをインスタンス化します。
オーバーロード・リスト:
このコンストラクタは、指定された名前を使用してOracleAQAgentクラスをインスタンス化します。
OracleAQAgent (string, string)
このコンストラクタは、指定された名前とアドレスを使用してOracleAQAgentクラスをインスタンス化します。
このコンストラクタは、指定された名前を使用してOracleAQAgentクラスをインスタンス化します。
宣言
// C#
public OracleAQAgent(string name);
パラメータ
name
エージェントの名前。
例外
ArgumentNullException - nameパラメータがnullです。
ArgumentException - nameパラメータが空です。
備考
エージェント名は、メッセージのプロデューサまたはコンシューマの名前を示します。Listenによって公開される機能においては、エージェント名は複数コンシューマ・キューでメッセージを待つコンシューマの名前に対応しています。メッセージにエージェント名を設定して、送信者の識別情報または目的のメッセージ受信者を示すこともできます。
このコンストラクタは、指定された名前とアドレスを使用してOracleAQAgentクラスをインスタンス化します。
宣言
// C# public OracleAQAgent(string name, string address);
パラメータ
name
エージェントの名前。
address
アドレスの形式は[schema.]queue[@dblink]です。
例外
ArgumentNullException - addressパラメータがnullです。
ArgumentException - addressパラメータが空です。
備考
エージェント名は、メッセージのプロデューサまたはコンシューマの名前を示します。Listenによって公開される機能においては、エージェント名は複数コンシューマ・キューでメッセージを待つコンシューマの名前に対応しています。
このコンストラクタでは、nameパラメータをnullとして指定できます。その場合、エージェントはaddressのみを持ちます。
addressパラメータは、このエージェントが新規メッセージをリスニングするキューの名前を示します。addressは、ローカル・データベースまたはリモート・データベースのキューを表します。addressの妥当性は暗黙的にチェックされません。addressが間違っていた場合の例外は、Listenなどのデータベース操作の実行中にのみスローされます。
OracleAQAgentプロパティを、表12-3にリストします。
このインスタンス・プロパティは、エージェントのアドレスを指定します。
宣言
// C#
public string Address {get; }
プロパティ値
エージェントのアドレスを指定するstring。
備考
このアドレスは、ローカル・データベースまたはリモート・データベースのキューを表します。デフォルト値はnullです。エージェントのアドレスは[schema.]queue[@dblink]という形式を取ります。文字列の長さは最大128文字です。
