WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

IMapMessage

對映訊息是一種其主體包含一組名稱值組(其中每一個值都有一個相關聯的資料類型)的訊息。

繼承階層:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IMessage
           |
           +----IBM.XMS.IMapMessage

當應用程式取得名稱值組的值時,該值可由 XMS 轉換成另一種資料類型。如需這種隱含轉換形式的相關資訊,請參閱對映訊息

相關參考
對映訊息

.NET 內容

.NET 內容摘要:
.NET 內容 說明
MapNames 取得對映訊息主體中之名稱的列舉表。

MapNames – 取得對映名稱

介面:
System.Collections.IEnumerator MapNames
{
  get;
}

取得對映訊息主體中之名稱的列舉表。

異常狀況:
  • XMSException

方法

方法摘要:
方法 說明
GetBoolean 從對映訊息主體中取得名稱所識別的 Boolean 值。
GetByte 從對映訊息主體中取得名稱所識別的位元組。
GetBytes 從對映訊息主體中取得名稱所識別的位元組陣列。
GetChar 從對映訊息主體中取得名稱所識別的字元。
GetDouble 從對映訊息主體中取得名稱所識別的倍精準度浮點數。
GetFloat 從對映訊息主體中取得名稱所識別的浮點數。
GetInt 從對映訊息主體中取得名稱所識別的整數。
GetLong 從對映訊息主體中取得名稱所識別的長整數。
GetObject 從對映訊息主體中取得名稱值組之值的參照。
GetShort 從對映訊息主體中取得名稱所識別的短整數。
GetString 從對映訊息主體中取得名稱所識別的字串。
ItemExists 檢查對映訊息主體是否含有指定名稱的名稱值組。
SetBoolean 在對映訊息主體中設定一個 Boolean 值。
SetByte 在對映訊息主體中設定一個位元組。
SetBytes 在對映訊息主體中設定一個位元組陣列。
SetChar 在對映訊息主體中設定一個二位元組字元。
SetDouble 在對映訊息主體中設定一個倍精準度浮點數。
SetFloat 在對映訊息主體中設定一個浮點數。
SetInt 在對映訊息主體中設定一個整數。
SetLong 在對映訊息主體中設定一個長整數。
SetObject 在對映訊息主體中設定一值,且必須是 XMS 初始類型。
SetShort 在對映訊息主體中設定一個短整數。
SetString 在對映訊息主體中設定一個字串。

GetBoolean – 取得 Boolean 值

介面:
Boolean GetBoolean(String name);

從對映訊息主體中取得名稱所識別的 Boolean 值。

參數:
name(輸入)
封裝 Boolean 值識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的 Boolean 值。
異常狀況:
  • XMSException

GetByte – 取得位元組

介面:
Byte    GetByte(String name);
    Int16   GetSignedByte(String name);

從對映訊息主體中取得名稱所識別的位元組。

參數:
name(輸入)
封裝位元組識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的位元組。位元組不會進行任何資料轉換。
異常狀況:
  • XMSException

GetBytes – 取得位元組

介面:
Byte[]  GetBytes(String name);

從對映訊息主體中取得名稱所識別的位元組陣列。

參數:
name(輸入)
封裝位元組陣列識別名稱的 String 物件。
傳回:
陣列中的位元組數。
異常狀況:
  • XMSException

GetChar – 取得字元

介面:
Char    GetChar(String name);

從對映訊息主體中取得名稱所識別的字元。

參數:
name (輸入)
封裝字元識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的字元。
異常狀況:
  • XMSException

GetDouble – 取得倍精準度浮點數

介面:
Double  GetDouble(String name);

從對映訊息主體中取得名稱所識別的倍精準度浮點數。

參數:
name(輸入)
封裝倍精準度浮點數識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的倍精準度浮點數。
異常狀況:
  • XMSException

GetFloat – 取得浮點數

介面:
Single  GetFloat(String name);

從對映訊息主體中取得名稱所識別的浮點數。

參數:
name(輸入)
封裝浮點數識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的浮點數。
異常狀況:
  • XMSException

GetInt – 取得整數

介面:
Int32   GetInt(String name);

從對映訊息主體中取得名稱所識別的整數。

參數:
name(輸入)
封裝整數識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的整數。
異常狀況:
  • XMSException

GetLong – 取得長整數

介面:
Int64   GetLong(String name);

從對映訊息主體中取得名稱所識別的長整數。

參數:
name(輸入)
封裝長整數識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的長整數。
異常狀況:
  • XMSException

GetObject – 取得物件

介面:
Object  GetObject(String name);

從對映訊息主體中取得名稱值組之值的參照。名稱值組是以名稱來識別。

參數:
name(輸入)
封裝名稱值組名稱的 String 物件。
傳回:
值,可為下列一種物件類型:
  • Boolean
  • Byte
  • Byte[]
  • Char
  • Double
  • Single
  • Int32
  • Int64
  • Int16
  • String
異常狀況:
XMSException

GetShort – 取得短整數

介面:
Int16   GetShort(String name);

從對映訊息主體中取得名稱所識別的短整數。

參數:
name(輸入)
封裝短整數識別名稱的 String 物件。
傳回:
擷取自對映訊息主體的短整數。
異常狀況:
  • XMSException

GetString – 取得字串

介面:
String  GetString(String name);

從對映訊息主體中取得名稱所識別的字串。

參數:
name(輸入)
封裝對映訊息主體中之字串識別名稱的 String 物件。
傳回:
封裝擷取自對映訊息主體中之字串的 String 物件。如果需要轉換資料, 則此為轉換後的字串。
異常狀況:
  • XMSException

ItemExists – 檢查名稱值組是否存在

介面:
Boolean ItemExists(String name);

檢查對映訊息主體是否含有指定名稱的名稱值組。

參數:
name(輸入)
封裝名稱值組名稱的 String 物件。
傳回:
  • 如果對映訊息主體含有一個指定名稱的名稱值組,則為 True
  • 如果對映訊息主體不含一個指定名稱的名稱值組,則為 False
異常狀況:
  • XMSException

SetBoolean – 設定 Boolean 值

介面:
void  SetBoolean(String name, Boolean value);

在對映訊息主體中設定一個 Boolean 值。

參數:
name(輸入)
封裝對映訊息主體中之 Boolean 值識別名稱的 String 物件。
value(輸入)
要設定的 Boolean 值。
傳回:
Void
異常狀況:
  • XMSException

SetByte – 設定位元組

介面:
void  SetByte(String name, Byte value);
void  SetSignedByte(String name, Int16 value);

在對映訊息主體中設定一個位元組。

參數:
name(輸入)
封裝對映訊息主體中之位元組識別名稱的 String 物件。
value(輸入)
要設定的位元組。
傳回:
Void
異常狀況:
  • XMSException

SetBytes – 設定多個位元組

介面:
void  SetBytes(String name, Byte[] value);

在對映訊息主體中設定一個位元組陣列。

參數:
name(輸入)
封裝對映訊息主體中之位元組陣列識別名稱的 String 物件。
value(輸入)
要設定的位元組陣列。
傳回:
Void
異常狀況:
  • XMSException

SetChar – 設定字元

介面:
void  SetChar(String name, Char value);

在對映訊息主體中設定一個二位元組字元。

參數:
name(輸入)
封裝對映訊息主體中之字元識別名稱的 String 物件。
value(輸入)
要設定的字元。
傳回:
Void
異常狀況:
  • XMSException

SetDouble – 設定倍精準度浮點數

介面:
void  SetDouble(String name, Double value);

在對映訊息主體中設定一個倍精準度浮點數。

參數:
name(輸入)
封裝對映訊息主體中之倍精準度浮點數識別名稱的 String 物件。
value(輸入)
要設定的倍精準度浮點數。
傳回:
Void
異常狀況:
  • XMSException

SetFloat – 設定浮點數

介面:
void  SetFloat(String name, Single value);

在對映訊息主體中設定一個浮點數。

參數:
name(輸入)
封裝對映訊息主體中之浮點數識別名稱的 String 物件。
value(輸入)
要設定的浮點數。
傳回:
Void
異常狀況:
  • XMSException

SetInt – 設定整數

介面:
void  SetInt(String name, Int32 value);

在對映訊息主體中設定一個整數。

參數:
name(輸入)
封裝對映訊息主體中之整數識別名稱的 String 物件。
value(輸入)
要設定的整數。
傳回:
Void
異常狀況:
  • XMSException

SetLong – 設定長整數

介面:
void  SetLong(String name, Int64 value);

在對映訊息主體中設定一個長整數。

參數:
name(輸入)
封裝對映訊息主體中之長整數識別名稱的 String 物件。
value(輸入)
要設定的長整數。
傳回:
Void
異常狀況:
  • XMSException

SetObject – 設定物件

介面:
void  SetObject(String name, Object value);

在對映訊息主體中設定一值,且必須是 XMS 初始類型。

參數:
name(輸入)
封裝對映訊息主體中之值識別名稱的 String 物件。
value(輸入)
內含所設之值的位元組陣列。
傳回:
Void
異常狀況:
  • XMSException

SetShort – 設定短整數

介面:
void  SetShort(String name, Int16 value);

在對映訊息主體中設定一個短整數。

參數:
name(輸入)
封裝對映訊息主體中之短整數識別名稱的 String 物件。
value(輸入)
要設定的短整數。
傳回:
Void
異常狀況:
  • XMSException

SetString – 設定字串

介面:
void  SetString(String name, String value);

在對映訊息主體中設定一個字串。

參數:
name(輸入)
封裝對映訊息主體中之字串識別名稱的 String 物件。
value(輸入)
封裝所要設定之字串的 String 物件。
傳回:
Void
異常狀況:
  • XMSException

繼承的內容和方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)