System.Messaging 命名空間

提供允許連線、監控和管理網路上的訊息佇列，以及傳送、接收或預覽訊息的類別。

類別

AccessControlEntry	指定信任項 (Trustee) (使用者、群組或電腦) 的存取權限，以執行應用程式專有的一般性工作實作。
AccessControlList	包含存取控制項目的清單，指定一或多個信任者的存取權限。
ActiveXMessageFormatter	使用與 MSMQ ActiveX 元件相容的格式，將訊息佇列訊息主體的基本資料型別和其他物件序列化或還原序列化。
BinaryMessageFormatter	使用二進位格式將訊息佇列訊息的主體序列化或還原序列化物件，或連接物件的整個圖解。
Cursor	讀取佇列的訊息時，會使用 Cursor 保持 MessageQueue 中的特定位置。
DefaultPropertiesToSend	指定傳送 Message 執行個體 (Instance) 以外的物件至訊息佇列時將使用的預設屬性值。
Message	提供定義訊息佇列訊息所需屬性的存取。
MessageEnumerator	提供順向資料指標，進而列舉訊息佇列中的訊息。
MessagePropertyFilter	控制並選取當由訊息佇列窺視或接收訊息時所擷取的屬性。
MessageQueue	提供 Message Queuing 伺服器上的佇列存取。
MessageQueueAccessControlEntry	指定信任項 (Trustee) (使用者、群組或電腦) 執行訊息佇列工作的存取權。
MessageQueueCriteria	在使用 MessageQueue 類別的 GetPublicQueues() 方法執行查詢時，篩選訊息佇列。
MessageQueueEnumerator	提供順向資料指標，進而列舉訊息佇列中的訊息。
MessageQueueException	發生 Microsoft Message Queuing 內部錯誤時，所擲回的例外狀況。
MessageQueueInstaller	讓您安裝和設定執行應用程式時需要的佇列 (Queue)。 安裝 MessageQueue 時，安裝公用程式 (如 InstallUtil.exe) 會呼叫這個類別。
MessageQueuePermission	允許控制訊息處理的程式碼存取使用權限。
MessageQueuePermissionAttribute	允許宣告式 MessageQueue 使用權限檢查。
MessageQueuePermissionEntry	定義傳送訊息時的程式碼存取安全性權限集合的最小單位。
MessageQueuePermissionEntryCollection	包含 MessageQueuePermissionEntry 物件的強類型集合。
MessageQueueTransaction	提供訊息佇列內部交易。
MessagingDescriptionAttribute	指定屬性或事件的描述。
PeekCompletedEventArgs	提供 PeekCompleted 事件的資料。 當非同步窺視作業 (Asynchronous Peek Operation) 呼叫事件處理常式時，會將這個類別的執行個體 (Instance) 傳遞至處理常式。
ReceiveCompletedEventArgs	提供 ReceiveCompleted 事件的資料。 當非同步 (Asynchronous) 接收作業呼叫事件處理常式時，會將這個類別的執行個體 (Instance) 傳遞至處理常式。
SecurityContext	表示佇列中訊息的安全性內容。
Trustee	指定存取控制項目套用的使用者帳戶、群組帳戶或登入工作階段 (Session)。
XmlMessageFormatter	使用根據 XSD 結構描述定義的 XML 格式，將物件序列化為訊息主體，或從訊息主體還原序列化為物件。

介面

IMessageFormatter

序列化或還原序列化訊息佇列訊息主體中的物件。

列舉

AccessControlEntryType	指定是否允許、拒絕、或撤銷信任項 (Trustee) 的存取權限。
AcknowledgeTypes	指定 Message Queuing 傳回給傳送應用程式的通知訊息型別。
Acknowledgment	指定訊息傳遞的結果。
CryptographicProviderType	指定驗證數位簽章時可用的密碼編譯服務提供者。
EncryptionAlgorithm	指定用來加密私用 (Private) 訊息的訊息主體的加密 (Encryption) 演算法。
EncryptionRequired	指定佇列收到的訊息其私用層級。
GenericAccessRights	使用 Windows 2000 和 Windows NT 存取格式，指定 Message Queuing 對應至讀取、寫入和執行之標準和物件特定存取權限的通用存取權限集。
HashAlgorithm	指定訊息佇列在驗證訊息時所使用的雜湊演算法。
MessageLookupAction	指定要從訊息佇列窺視或接收的訊息。
MessagePriority	指定訊息佇列在抵達佇列途中以及將訊息插入目的佇列時，套用至訊息的優先權。
MessageQueueAccessRights	指定訊息佇列專屬作業的物件專用存取權集合。
MessageQueueErrorCode	識別在訊息佇列應用程式內發生的錯誤來源，並產生 MessageQueueException 例外狀況。
MessageQueuePermissionAccess	定義 System.Messaging 使用權限類別所使用的存取等級。
MessageQueueTransactionStatus	指定內部訊息佇列交易的狀態。
MessageQueueTransactionType	指定訊息佇列交易型別。
MessageType	辨認訊息的型別。 訊息可以是一般訊息佇列訊息、正 (抵達與讀取) 或負 (抵達與讀取) 通知訊息或報告訊息。
PeekAction	指出窺視佇列中目前的訊息，還是下一則訊息。
QueueAccessMode	在建立階段指定 MessageQueue 的存取模式。
StandardAccessRights	指定標準存取權集合以對應至通用於大部分安全物件型別的作業。
TrusteeType	指定信任項 (Trustee) 的型別。

委派

PeekCompletedEventHandler	代表將處理 PeekCompleted 之 MessageQueue 事件的方法。
ReceiveCompletedEventHandler	代表將處理 ReceiveCompleted 之 MessageQueue 事件的方法。

備註

類別 MessageQueue 的成員包含下列方法，可用來讀取和寫入佇列的訊息：

• 方法 Send 可讓您的應用程式將訊息寫入佇列。 方法的多載可讓您指定是否使用 Message (傳送訊息，以提供您傳送) 或任何其他 Managed 物件的詳細資訊控制，包括應用程式特定類別。 方法也支援在交易中傳送訊息。

• Receive、 ReceiveById 和 ReceiveByCorrelationId 方法提供從佇列讀取訊息的功能。 Send如同 方法，這些方法會提供支援交易佇列處理的多載。 這些方法也會提供逾時的多載。

  如果佇列是空的，可讓處理繼續的參數。 因為這些方法是同步處理的範例，所以除非指定逾時，否則會中斷目前的執行緒，直到訊息可用為止。

• 方法 Peek 類似于 Receive ，但不會在讀取訊息時從佇列中移除。 因為 Peek 不會變更佇列內容，所以沒有多載可支援交易處理。 不過，因為 Peek 例如 ，會 Receive 從佇列同步讀取訊息，所以 方法的多載確實支援指定逾時，以防止執行緒無限期地等候。

• BeginPeek、 EndPeek(IAsyncResult)BeginReceive 和 EndReceive(IAsyncResult) 方法提供從佇列非同步讀取訊息的方法。 它們不會在等候訊息抵達佇列時中斷目前的執行緒。

類別的 MessageQueue 下列方法提供依指定準則擷取佇列清單的功能，並判斷特定佇列是否存在：

• GetPrivateQueuesByMachine(String) 可擷取電腦上的私人佇列。

• GetPublicQueuesByCategory(Guid)、 GetPublicQueuesByLabel(String) 和 GetPublicQueuesByMachine(String) 提供一般準則擷取公用佇列的方法。 的多 GetPublicQueues 載提供更精細的詳細資料，可讓您根據許多搜尋準則來選取佇列。

類別的其他方法 MessageQueue 提供下列功能：

• 建立和刪除訊息佇列佇列。

• 使用訊息列舉值逐步執行佇列中的訊息。

• 使用佇列列舉值逐一查看系統上的佇列。

• 設定 ACL 型存取權限。

• 使用連線快取。

類別 Message 提供您傳送至佇列之資訊的詳細控制權，而且是接收或查看佇列訊息時所使用的物件。 除了訊息本文之外，類別的屬性 Message 包括通知設定、格式器選取、識別、驗證和加密資訊、時間戳記、使用追蹤、伺服器日誌和寄不出的信件佇列和交易資料的指示。

元件 MessageQueue 與下列三個格式器相關聯，可讓您序列化和還原序列化從佇列傳送和接收的訊息：

• 提供 XmlMessageFormatter 鬆散結合的傳訊，在用戶端和伺服器上啟用序列化類型的獨立版本控制。

• ActiveXMessageFormatter與 MSMQ COM 控制項相容。 它可讓您傳送控制項可接收的類型，以及接收控制項所傳送的類型。

• 提供 BinaryMessageFormatter 較快速的 XmlMessageFormatter 替代方案，但沒有鬆散結合傳訊的優點。

命名空間中的其他 Messaging 類別支援程式碼存取和 ACL 型安全性、從佇列讀取訊息時篩選 Message 屬性，以及在傳送和接收訊息時使用交易。