Connection 物件代表一條應用程式至分配管理系統的作用中連線。
IBM.XMS.IPropertyContext | +----IBM.XMS.IConnection
有關 XMS 所定義的 Connection 物件內容清單, 請參閱Connection 內容。
.NET 內容 | 說明 |
---|---|
ClientID | 取得和設定連線的用戶端 ID。 |
ExceptionListener | 取得已向連線登錄的異常狀況接聽器, 並向連線登錄一個異常狀況接聽器。 |
MetaData | 取得連線的 meta 資料。 |
String ClientID { get; set; }
用戶端 ID 可由管理者預先配置在 ConnectionFactory 中,或者藉由設定 ClientID 來指派。
用戶端 ID 只用來在發佈/訂閱網域中支援延續訂閱, 若在點對點網域中則會被忽略。
如果應用程式要設定連線的用戶端 ID,則 應用程式會在建立連線後旋即執行此作業,然後再對連線執行其他任何作業。如果應用程式在過了該時間點後才試著設定用戶端 ID, 則呼叫會擲出 IllegalStateException 異常狀況。
此內容不適用於和分配管理系統間的即時連線。
ExceptionListener ExceptionListener { get; set; }
取得已向連線登錄的異常狀況接聽器, 並向連線登錄一個異常狀況接聽器。
如果沒有任何異常狀況接聽器向連線登錄, 則方法會傳回空值。若有異常狀況接聽器已向連線登錄, 您可以改為指定一個空值(而不指定異常狀況接聽器),以取消登錄。
如需使用異常狀況接聽器的相關資訊, 請參閱在 .NET 中使用訊息和異常狀況接聽器。
方法 | 說明 |
---|---|
Close | 關閉連線。 |
CreateSession | 建立階段作業。 |
Start | 針對連線啟動或重新啟動送入訊息的遞送。 |
Stop | 針對連線停止送入訊息的遞送。 |
ISession CreateSession(Boolean transacted, AcknowledgeMode acknowledgeMode);
若為和分配管理系統間的即時連線, 此值必須是 False。
如果階段作業為交易式, 則會忽略這個參數。如需確認模式的相關資訊,請參閱在階段作業中確認收到訊息。