MessageQueuePermissionEntryCollection.Add(MessageQueuePermissionEntry) Method

Definition

Adds a specified MessageQueuePermissionEntry to this collection.

public:
 int Add(System::Messaging::MessageQueuePermissionEntry ^ value);
public int Add (System.Messaging.MessageQueuePermissionEntry value);
member this.Add : System.Messaging.MessageQueuePermissionEntry -> int
Public Function Add (value As MessageQueuePermissionEntry) As Integer

Parameters

Returns

The zero-based index of the added MessageQueuePermissionEntry.

Examples

The following code example demonstrates the use of Add.

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

// Create a new instance of MessageQueuePermission.
MessageQueuePermission^ permission = gcnew MessageQueuePermission();

// Get an instance of MessageQueuePermissionEntryCollection from the
// permission's PermissionEntries property.
MessageQueuePermissionEntryCollection^ collection =
    permission->PermissionEntries;

// Create a new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry^ entry = gcnew MessageQueuePermissionEntry(
    MessageQueuePermissionAccess::Receive, 
    queue->MachineName, 
    queue->Label, queue->Category.ToString());

// Add the entry to the collection.
collection->Add(entry);

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

// Create a new instance of MessageQueuePermission.
MessageQueuePermission permission = new MessageQueuePermission();

// Get an instance of MessageQueuePermissionEntryCollection from the
// permission's PermissionEntries property.
MessageQueuePermissionEntryCollection collection =
    permission.PermissionEntries;

// Create a new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry entry = new MessageQueuePermissionEntry(
    MessageQueuePermissionAccess.Receive,
    queue.MachineName,
    queue.Label,
    queue.Category.ToString());

// Add the entry to the collection.
collection.Add(entry);

Applies to