MessageQueuePermissionAttribute.Category Property

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Gets or sets the queue category.

public:
 property System::String ^ Category { System::String ^ get(); void set(System::String ^ value); };

public string Category { get; set; }

member this.Category : string with get, set

Public Property Category As String

Property Value

String

The queue category (Message Queuing type identifier), which allows an application to categorize its queues.

Exceptions

InvalidOperationException

The value is null.

Examples

The following code example gets and sets the value of a message queue permission attribute's Category property.

// Connect to a queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

// Create a new instance of MessageQueuePermissionAttribute.
MessageQueuePermissionAttribute^ attribute =
    gcnew MessageQueuePermissionAttribute(
    System::Security::Permissions::SecurityAction::Assert);

// Set the attribute's Category property value, based on the queue's
// Category property value.
attribute->Category = queue->Category.ToString();

// Display the new value of the attribute's Category property.
Console::WriteLine("attribute->Category: {0}",
    attribute->Category);

queue->Close();

// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Create a new instance of MessageQueuePermissionAttribute.
MessageQueuePermissionAttribute attribute =
    new MessageQueuePermissionAttribute(
    System.Security.Permissions.SecurityAction.Assert);

// Set the attribute's Category property value, based on the queue's
// Category property value.
attribute.Category = queue.Category.ToString();

// Display the new value of the attribute's Category property.
Console.WriteLine("attribute.Category: {0}",
    attribute.Category.ToString());