MessageQueuePermissionEntryCollection.Contains Method

Reference

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Determines whether this collection contains a specified MessageQueuePermissionEntry.

public:
 bool Contains(System::Messaging::MessageQueuePermissionEntry ^ value);

public bool Contains (System.Messaging.MessageQueuePermissionEntry value);

member this.Contains : System.Messaging.MessageQueuePermissionEntry -> bool

Public Function Contains (value As MessageQueuePermissionEntry) As Boolean

Parameters

value: MessageQueuePermissionEntry

The MessageQueuePermissionEntry to find.

Returns

Boolean

true if the specified MessageQueuePermissionEntry belongs to this collection; otherwise, false.

Examples

The following code example demonstrates the use of Contains.

// 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);

// Show that the collection contains the entry.
Console::WriteLine("Collection contains first entry (true/false): {0}",
    collection->Contains(entry));

// Create another new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry^ newEntry = 
    gcnew MessageQueuePermissionEntry(
    MessageQueuePermissionAccess::Send, 
    queue->MachineName, 
    queue->Label, 
    queue->Category.ToString());

// Show that the collection does not contain the new entry.
Console::WriteLine(
    "Collection contains second entry (true/false): {0}",
    collection->Contains(newEntry));

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);

// Show that the collection contains the entry.
Console.WriteLine("Collection contains first entry (true/false): {0}",
    collection.Contains(entry));

// Create another new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry newEntry = new MessageQueuePermissionEntry(
    MessageQueuePermissionAccess.Send,
    queue.MachineName,
    queue.Label,
    queue.Category.ToString());

// Show that the collection does not contain the new entry.
Console.WriteLine("Collection contains second entry (true/false): {0}",
    collection.Contains(newEntry));

Applies to

Share via