OracleAQAgentクラス

OracleAQAgentクラスは、メッセージの送信者または受信者となるエージェントを表します。

クラスの継承

System.Object

OracleAQAgent

宣言

// C#
public sealed class OracleAQAgent

要件

プロバイダ	ODP.NET管理対象外ドライバ
アセンブリ	`Oracle.DataAccess.dll`
ネームスペース	`Oracle.DataAccess.Client`
.NET Framework	3.5, 4.0, 4.5

スレッド安全性

パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。

備考

エージェントは、コンシューマ、別のキュー、別のキューのコンシューマのいずれかです。キューは、ローカルまたはリモートです。リモート・キューは、データベース・リンクを通じて指定します。

関連項目:

OracleAQAgentメンバー

OracleAQAgentメンバーを、次の各表に示します。

OracleAQAgentコンストラクタ

OracleAQAgentコンストラクタを、表12-1にリストします。

表12-1 OracleAQAgentコンストラクタ

コンストラクタ	説明
OracleAQAgentコンストラクタ	`OracleAQAgent`クラスの新規インスタンスをインスタンス化します(オーバーロード)。

OracleAQAgentプロパティ

OracleAQAgentプロパティを、表12-2にリストします。

表12-2 OracleAQAgentプロパティ

プロパティ	説明
アドレス	エージェントのアドレスを指定します。
名前	エージェントの名前を指定します。

関連項目:

OracleAQAgentコンストラクタ

OracleAQAgentコンストラクタは、OracleAQAgentクラスの新規インスタンスをインスタンス化します。

オーバーロード・リスト:

OracleAQAgent (string)

このコンストラクタは、指定された名前を使用してOracleAQAgentクラスをインスタンス化します。
OracleAQAgent (string, string)

このコンストラクタは、指定された名前とアドレスを使用してOracleAQAgentクラスをインスタンス化します。

関連項目:

OracleAQAgent (string)

このコンストラクタは、指定された名前を使用してOracleAQAgentクラスをインスタンス化します。

宣言

// C#
public OracleAQAgent(string name);

パラメータ

name

エージェントの名前。

例外

ArgumentNullException - nameパラメータがnullです。

ArgumentException - nameパラメータが空です。

備考

エージェント名は、メッセージのプロデューサまたはコンシューマの名前を示します。Listenによって公開される機能においては、エージェント名は複数コンシューマ・キューでメッセージを待つコンシューマの名前に対応しています。メッセージにエージェント名を設定して、送信者の識別情報または目的のメッセージ受信者を示すこともできます。

関連項目:

OracleAQAgent (string, string)

このコンストラクタは、指定された名前とアドレスを使用して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プロパティ

OracleAQAgentプロパティを、表12-3にリストします。

表12-3 OracleAQAgentプロパティ

プロパティ	説明
アドレス	エージェントのアドレスを指定します。
名前	エージェントの名前を指定します。

関連項目:

Address

このインスタンス・プロパティは、エージェントのアドレスを指定します。

宣言

// C#
public string Address {get; }

プロパティ値

エージェントのアドレスを指定するstring。

備考

このアドレスは、ローカル・データベースまたはリモート・データベースのキューを表します。デフォルト値はnullです。エージェントのアドレスは[schema.]queue[@dblink]という形式を取ります。文字列の長さは最大128文字です。

関連項目:

名前

このインスタンス・プロパティは、エージェントの名前を指定します。

宣言

// C#
public string Name {get; }

プロパティ値

string

備考

デフォルトはnullです。文字列の長さは最大30文字です。値がnull以外の場合、このエージェント名は複数コンシューマ・キューのコンシューマ名またはメッセージ・プロパティに指定された受信者に対応しています。

関連項目: