MessageQueuePermissionEntryCollection.Insert Methode

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Fügt einen Berechtigungseintrag an einem angegebenen Index in diese Auflistung ein.

public:
 void Insert(int index, System::Messaging::MessageQueuePermissionEntry ^ value);

public void Insert (int index, System.Messaging.MessageQueuePermissionEntry value);

member this.Insert : int * System.Messaging.MessageQueuePermissionEntry -> unit

Public Sub Insert (index As Integer, value As MessageQueuePermissionEntry)

Parameter

index

Int32

Der nullbasierte Index der Auflistung, an dem der Berechtigungseintrag eingefügt werden soll.

value

MessageQueuePermissionEntry

Der in diese Auflistung einzufügende Berechtigungseintrag.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von Insert.

// 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 another new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry^ newEntry = 
    gcnew MessageQueuePermissionEntry(
    MessageQueuePermissionAccess::Send, 
    queue->MachineName, 
    queue->Label, 
    queue->Category.ToString());

// Insert the new entry into the collection before the original entry.
collection->Insert(0, 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);

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

// Insert the new entry into the collection before the original entry.
collection.Insert(0, newEntry);