MessageQueuePermissionEntryCollection.CopyTo-Methode

Kopiert die Berechtigungseinträge aus dieser Auflistung in ein Array, beginnend an einem bestimmten Index im Array.

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

Syntax

'Declaration
Public Sub CopyTo ( _
    array As MessageQueuePermissionEntry(), _
    index As Integer _
)
'Usage
Dim instance As MessageQueuePermissionEntryCollection
Dim array As MessageQueuePermissionEntry()
Dim index As Integer

instance.CopyTo(array, index)

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

public:
void CopyTo (
    array<MessageQueuePermissionEntry^>^ array, 
    int index
)

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

public function CopyTo (
    array : MessageQueuePermissionEntry[], 
    index : int
)

Parameter

• array
  Ein Array vom Typ MessageQueuePermissionEntry, das die Berechtigungseinträge dieser Auflistung empfängt.

• index
  Der nullbasierte Index, an dem mit dem Kopieren der Berechtigungseinträge begonnen werden soll.

Beispiel

Im folgenden Codebeispiel wird die Verwendung von CopyTo veranschaulicht.

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

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

// Create an array of type MessageQueuePermissionEntry.
array<MessageQueuePermissionEntry^>^ entries = 
    gcnew array<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);

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.get_PermissionEntries();
// Create a new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry entry = new MessageQueuePermissionEntry(
    MessageQueuePermissionAccess.Receive, queue.get_MachineName(),
    queue.get_Label(), queue.get_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].get_PermissionAccess());
Console.WriteLine("entries[0].MachineName: {0}",
    entries[0].get_MachineName());
Console.WriteLine("entries[0].Label: {0}",
    entries[0].get_Label());
Console.WriteLine("entries[0].Category: {0}",
    entries[0].get_Category().ToString());

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageQueuePermissionEntryCollection-Klasse
MessageQueuePermissionEntryCollection-Member
System.Messaging-Namespace