| Oracle Data Provider for .NET開発者ガイド 11gリリース1（11.1.0.7.20） B56255-01 |
|
 戻る |
 次へ |
OracleAQAgentクラスは、メッセージの送信者または受信者となるエージェントを表します。
クラスの継承
System.Object
OracleAQAgent
宣言
// C# public sealed class OracleAQAgent
スレッド安全性
パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。
備考
エージェントは、コンシューマ、別のキュー、別のキューのコンシューマのいずれかです。キューは、ローカルまたはリモートです。リモート・キューは、データベース・リンクを通じて指定します。
要件
ネームスペース: Oracle.DataAccess.Client
アセンブリ: Oracle.DataAccess.dll
Microsoft .NET Framework Version: 2.0以降
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文字です。
このインスタンス・プロパティは、エージェントの名前を指定します。
宣言
// C#
public string Name {get; }
プロパティ値
string
備考
デフォルトはnullです。文字列の長さは最大30文字です。値がnull以外の場合、このエージェント名は複数コンシューマ・キューのコンシューマ名またはメッセージ・プロパティに指定された受信者に対応しています。
