MessageQueuePermissionEntryCollection.CopyTo Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Copia las entradas de permiso de esta colección en una matriz, comenzando en un índice determinado de la matriz.
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)
Parámetros
- array
- MessageQueuePermissionEntry[]
Matriz de tipo MessageQueuePermissionEntry que recibe las entradas de permisos de la colección.
- index
- Int32
Índice de base cero en el que se comienzan a copiar las entradas de permiso.
Ejemplos
En el siguiente ejemplo de código se muestra el uso de 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());