Export (0) Print
Expand All

MessageQueuePermissionEntryCollection.CopyTo Method

Copies the permission entries from this collection to an array, starting at a particular index of the array.

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

public void CopyTo(
	MessageQueuePermissionEntry[] array,
	int index
)

Parameters

array
Type: System.Messaging.MessageQueuePermissionEntry[]

An array of type MessageQueuePermissionEntry that receives this collection's permission entries.

index
Type: System.Int32

The zero-based index at which to begin copying the permission entries.

The following code example demonstrates the use of CopyTo.

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

// Create an array of type MessageQueuePermissionEntry.
MessageQueuePermissionEntry[] entries =
    new MessageQueuePermissionEntry[1];

// Copy the collection to index 0 of the array.
collection.CopyTo(entries, 0);

// Show that the array now contains the entry.
Console.WriteLine("entries[0].PermissionAccess: {0}",
    entries[0].PermissionAccess);
Console.WriteLine("entries[0].MachineName: {0}",
    entries[0].MachineName);
Console.WriteLine("entries[0].Label: {0}", entries[0].Label);
Console.WriteLine("entries[0].Category: {0}",
    entries[0].Category.ToString());

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft