MessageQueuePermissionEntryCollection.Insert-Methode

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

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

Syntax

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

instance.Insert(index, value)

public void Insert (
    int index,
    MessageQueuePermissionEntry value
)

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

public void Insert (
    int index, 
    MessageQueuePermissionEntry value
)

public function Insert (
    index : int, 
    value : MessageQueuePermissionEntry
)

Parameter

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

• value
  Der in diese Auflistung einzufügende Berechtigungseintrag.

Beispiel

Im folgenden Codebeispiel wird die Verwendung von Insert 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 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);

// 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.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 another new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry newEntry =
    new MessageQueuePermissionEntry(MessageQueuePermissionAccess.Send,
    queue.get_MachineName(), queue.get_Label(),
    queue.get_Category().ToString());
// Insert the new entry into the collection before the original entry.
collection.Insert(0, newEntry);

.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