MessageQueuePermissionEntryCollection.CopyTo Method
Definition
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.
Copies the permission entries from this collection to an array, starting at a particular index of the array.
public:
void CopyTo(cli::array <System::Messaging::MessageQueuePermissionEntry ^> ^ array, int index);
public void CopyTo (System.Messaging.MessageQueuePermissionEntry[] array, int index);
member this.CopyTo : System.Messaging.MessageQueuePermissionEntry[] * int -> unit
Public Sub CopyTo (array As MessageQueuePermissionEntry(), index As Integer)
Parameters
- array
- MessageQueuePermissionEntry[]
An array of type MessageQueuePermissionEntry that receives this collection's permission entries.
- index
- Int32
The zero-based index at which to begin copying the permission entries.
Examples
The following code example demonstrates the use of CopyTo.
// 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.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());
Applies to
שתף איתנו פעולה ב- GitHub
ניתן למצוא את המקור לתוכן זה ב- GitHub, שם ניתן גם ליצור ולסקור בעיות ולמשוך בקשות. לקבלת מידע נוסף, עיין במדריך התורמים שלנו.