MessageQueuePermissionEntryCollection.Insert 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

將使用權限項目插入至這個集合的指定索引。

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)

參數

index

Int32

以零起始的集合索引，要插入使用權限項目的所在位置。

value

MessageQueuePermissionEntry

要插入至這個集合的使用權限項目。

範例

下列程式碼範例示範 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);