MessagePriority Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the priority Message Queuing applies to a message while it is en route to a queue, and when inserting the message into the destination queue.

Namespace:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

type MessagePriority

Member nameDescription
AboveNormal

Between High and Normal message priority.

High

High message priority.

Highest

Highest message priority.

Low

Low message priority.

Lowest

Lowest message priority.

Normal

Normal message priority.

VeryHigh

Between Highest and High message priority.

VeryLow

Between Low and Lowest message priority.

The MessagePriority enumeration is used by the Message class's Priority property. This property affects how Message Queuing handles the message both while it is en route and once it reaches its destination. Higher-priority messages are given preference during routing and inserted toward the front of the destination queue. Messages with the same priority are placed in the queue according to their arrival time.

When Message Queuing routes a message to a public queue, the priority level of the message is added to the priority level of the public queue (which you can access through the MessageQueue class's BasePriority property). The priority level of the queue has no effect on how messages are placed in the queue, only on how Message Queuing handles the message while en route.

Base priority applies only to public queues. For a private queue, the base priority is always zero.

You can set a meaningful priority only for non-transactional messages. Message Queuing automatically sets the priority for transactional messages to Lowest, which causes transactional message priority to be ignored.

The following example sends two messages of different priorities to the queue, and retrieves them subsequently.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: