MessageQueuePermissionEntryCollection.AddRange 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

附加一組指定的使用權限項目至這個集合。

多載

AddRange(MessageQueuePermissionEntry[])	附加一組指定的使用權限項目至這個集合。
AddRange(MessageQueuePermissionEntryCollection)	附加一組指定的使用權限項目至這個集合。

AddRange(MessageQueuePermissionEntry[])

附加一組指定的使用權限項目至這個集合。

public:
 void AddRange(cli::array <System::Messaging::MessageQueuePermissionEntry ^> ^ value);

public void AddRange (System.Messaging.MessageQueuePermissionEntry[] value);

member this.AddRange : System.Messaging.MessageQueuePermissionEntry[] -> unit

Public Sub AddRange (value As MessageQueuePermissionEntry())

參數

value

MessageQueuePermissionEntry[]

型別 MessageQueuePermissionEntry 物件的陣列，含有要加入的使用權限項目。

範例

下列程式碼範例示範 AddRange(MessageQueuePermissionEntry[]) 的用法。

// 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 an array of type MessageQueuePermissionEntry.
array<MessageQueuePermissionEntry^>^ entries = 
    gcnew array<MessageQueuePermissionEntry^>(1);

// Create a new instance of MessageQueuePermissionEntry and place the
// instance in the array.
entries[0] = gcnew MessageQueuePermissionEntry(
    MessageQueuePermissionAccess::Receive, 
    queue->MachineName, 
    queue->Label, 
    queue->Category.ToString());

// Add the array to the collection.
collection->AddRange(entries);

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 an array of type MessageQueuePermissionEntry.
MessageQueuePermissionEntry[] entries =
    new MessageQueuePermissionEntry[1];

// Create a new instance of MessageQueuePermissionEntry and place the
// instance in the array.
entries[0] = new MessageQueuePermissionEntry(
    MessageQueuePermissionAccess.Receive,
    queue.MachineName,
    queue.Label,
    queue.Category.ToString());

// Add the array to the collection.
collection.AddRange(entries);

AddRange(MessageQueuePermissionEntryCollection)

附加一組指定的使用權限項目至這個集合。

public:
 void AddRange(System::Messaging::MessageQueuePermissionEntryCollection ^ value);

public void AddRange (System.Messaging.MessageQueuePermissionEntryCollection value);

member this.AddRange : System.Messaging.MessageQueuePermissionEntryCollection -> unit

Public Sub AddRange (value As MessageQueuePermissionEntryCollection)

參數

value

MessageQueuePermissionEntryCollection

MessageQueuePermissionEntryCollection，包含要加入的使用權限項目。

範例

下列程式碼範例示範 AddRange(MessageQueuePermissionEntryCollection) 的用法。

// Connect to a queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

// Create a new instance of MessageQueuePermission.
MessageQueuePermission^ permission = gcnew MessageQueuePermission();

// Create a new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry^ entry = gcnew MessageQueuePermissionEntry(
    MessageQueuePermissionAccess::Receive, 
    queue->MachineName, 
    queue->Label, queue->Category.ToString());

// Add the entry to the permission's collection.
permission->PermissionEntries->Add(entry);

// Create another new instance of MessageQueuePermission.
MessageQueuePermission^ newPermission = gcnew MessageQueuePermission();

// Use AddRange() to append the original permission's collection to the
// new permission's collection.
newPermission->PermissionEntries->AddRange(
    permission->PermissionEntries);

// To show that AddRange() copies collections by value and not by
// reference, we'll clear the original permission's collection, then
// display a count of how many entries are in the original permission's
// collection and how many entries are in the new permission's
// collection.

// Clear the original permission's collection.
permission->PermissionEntries->Clear();

// The original permission now contains 0 entries, but the new
// permission still contains 1 entry.
Console::WriteLine("Original permission contains {0} entries.",
    permission->PermissionEntries->Count);
Console::WriteLine("New permission contains {0} entries.",
    newPermission->PermissionEntries->Count);

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();

// Create a new instance of MessageQueuePermissionEntry.
MessageQueuePermissionEntry entry = new MessageQueuePermissionEntry(
    MessageQueuePermissionAccess.Receive,
    queue.MachineName,
    queue.Label,
    queue.Category.ToString());

// Add the entry to the permission's collection.
permission.PermissionEntries.Add(entry);

// Create another new instance of MessageQueuePermission.
MessageQueuePermission newPermission = new MessageQueuePermission();

// Use AddRange() to append the original permission's collection to the
// new permission's collection.
newPermission.PermissionEntries.AddRange(permission.PermissionEntries);

// To show that AddRange() copies collections by value and not by
// reference, we'll clear the original permission's collection, then
// display a count of how many entries are in the original permission's
// collection and how many entries are in the new permission's
// collection.

// Clear the original permission's collection.
permission.PermissionEntries.Clear();

// The original permission now contains 0 entries, but the new
// permission still contains 1 entry.
Console.WriteLine("Original permission contains {0} entries.",
    permission.PermissionEntries.Count);
Console.WriteLine("New permission contains {0} entries.",
    newPermission.PermissionEntries.Count);