Connection オブジェクトは、アプリケーションによるブローカーへのアクティブな接続を表します。
IBM.XMS.IPropertyContext | +----IBM.XMS.IConnection
Connection オブジェクトの XMS 定義プロパティーのリストについては、Connection のプロパティーを参照してください。
.NET プロパティー | 説明 |
---|---|
ClientID | 接続のクライアント ID を取得および設定します。 |
ExceptionListener | 接続に登録されている例外リスナーを取得し、例外リスナーを接続に登録します。 |
MetaData | 接続のメタデータを取得します。 |
String ClientID { get; set; }
クライアント ID は、管理者が ConnectionFactory で事前に構成するか、ClientID を設定することにより割り当てることができます。
クライアント ID は、パブリッシュ/サブスクライブ・ドメイン内の永続サブスクリプションをサポートするためだけに使用され、Point-to-Point ドメインでは無視されます。
アプリケーションが接続のクライアント ID を設定する場合、アプリケーションは、接続の作成の直後に、接続で他の操作を実行する前にこの設定を行う必要があります。アプリケーションが、この時点よりも後に、このクライアント ID の設定を試行すると、呼び出しは例外 IllegalStateException をスローします。
ブローカーへのリアルタイム接続の場合、このプロパティーは無効です。
ExceptionListener ExceptionListener { get; set; }
接続に登録されている例外リスナーを取得し、例外リスナーを接続に登録します。
接続に例外リスナーが登録されていない場合、このメソッドでは NULL が戻されます。接続に例外リスナーが既に登録されている場合は、この例外リスナーの代わりに NULL を指定すれば、登録を取り消すことができます。
例外リスナーの使用について詳しくは、.NET でのメッセージ・リスナーおよび例外リスナーの使用法を参照してください。
メソッド | 説明 |
---|---|
Close | 接続を閉じます。 |
CreateSession | セッションを作成します。 |
Start | 接続の着信メッセージの配信を開始または再開します。 |
Stop | 接続の着信メッセージの配信を停止します。 |
ISession CreateSession(Boolean transacted, AcknowledgeMode acknowledgeMode);
ブローカーへのリアルタイム接続の場合、値は False である必要があります。
セッションが処理済みの場合、このパラメーターは無視されます。肯定応答モードについて詳しくは、セッションでのメッセージの受信の確認を参照してください。