共用方式為


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

代表將處理 PeekCompletedMessageQueue 事件的方法。

ReceiveCompletedEventHandler

代表將處理 ReceiveCompletedMessageQueue 事件的方法。

備註

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

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

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

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

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

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

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

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

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

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

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

  • 設定 ACL 型存取權限。

  • 使用連線快取。

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

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

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