MessageQueuePermissionEntryCollection.AddRange Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Appends a set of specified permission entries to this collection.
AddRange(MessageQueuePermissionEntry[]) |
Appends a set of specified permission entries to this collection. |
AddRange(MessageQueuePermissionEntryCollection) |
Appends a set of specified permission entries to this collection. |
Appends a set of specified permission entries to this collection.
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())
Parameters
- value
- MessageQueuePermissionEntry[]
An array of type MessageQueuePermissionEntry objects that contains the permission entries to add.
Examples
The following code example demonstrates the use of 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);
Applies to
.NET Framework 4.8.1 and other versions
Product | Versions |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Appends a set of specified permission entries to this collection.
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)
Parameters
A MessageQueuePermissionEntryCollection that contains the permission entries to add.
Examples
The following code example demonstrates the use of 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);
Applies to
.NET Framework 4.8.1 and other versions
Product | Versions |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: