MessageQueueCriteria.Category Property

 
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.

Gets or sets the category by which to filter queues in the network.

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

public Guid Category { get; set; }

Property Value

Type: System.Guid

The queues' category.

Exception Condition
InvalidOperationException

The application did not set the Category property before reading it.

The queue category allows an application to categorize its queues. For example, you can place all Billing queues in one category and all Order queues in another. The Category property is application-defined and has no intrinsic meaning to Message Queuing.

If you are filtering only by category when searching the queues on the network, you can use the method GetPublicQueuesByCategory, which is specifically designed for this purpose. If you are searching by multiple criteria that include the category, set this Category property and pass the parameter into GetPublicQueues.

.NET Framework
Available since 1.1
Return to top
Show: