MessageQueuePermissionEntryCollection.CopyTo メソッド

.NET Framework クラス ライブラリ リファレンス

MessageQueuePermissionEntryCollection.CopyTo メソッド

配列内の特定のインデックスを開始位置として、その配列にコレクションからアクセス許可エントリをコピーします。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Sub CopyTo ( _
    array As MessageQueuePermissionEntry(), _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As MessageQueuePermissionEntryCollection
Dim array As MessageQueuePermissionEntry()
Dim index As Integer

instance.CopyTo(array, index)

C#

public void CopyTo (
    MessageQueuePermissionEntry[] array,
    int index
)

C++

public:
void CopyTo (
    array<MessageQueuePermissionEntry^>^ array, 
    int index
)

J#

public void CopyTo (
    MessageQueuePermissionEntry[] array, 
    int index
)

JScript

public function CopyTo (
    array : MessageQueuePermissionEntry[], 
    index : int
)

パラメータ

array

このコレクションのアクセス許可エントリを受け取る MessageQueuePermissionEntry 型の配列。

index

アクセス許可エントリのコピーを開始する位置を示す 0 から始まるインデックス。

使用例

CopyTo の使用方法を次のコード例に示します。

C#

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

// Copy the collection to index 0 of the array.
collection.CopyTo(entries, 0);

// Show that the array now contains the entry.
Console.WriteLine("entries[0].PermissionAccess: {0}",
    entries[0].PermissionAccess);
Console.WriteLine("entries[0].MachineName: {0}",
    entries[0].MachineName);
Console.WriteLine("entries[0].Label: {0}", entries[0].Label);
Console.WriteLine("entries[0].Category: {0}",
    entries[0].Category.ToString());

C++

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

// Copy the collection to index 0 of the array.
collection->CopyTo(entries, 0);

// Show that the array now contains the entry.
Console::WriteLine("entries[0].PermissionAccess: {0}",
    entries[0]->PermissionAccess);
Console::WriteLine("entries[0].MachineName: {0}",
    entries[0]->MachineName);
Console::WriteLine("entries[0].Label: {0}", entries[0]->Label);
Console::WriteLine("entries[0].Category: {0}",
    entries[0]->Category);

queue->Close();

J#

// 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 an array of type MessageQueuePermissionEntry.
MessageQueuePermissionEntry entries[] =
    new MessageQueuePermissionEntry[1];
// Copy the collection to index 0 of the array.
collection.CopyTo(entries, 0);
// Show that the array now contains the entry.
Console.WriteLine("entries[0].PermissionAccess: {0}",
    entries[0].get_PermissionAccess());
Console.WriteLine("entries[0].MachineName: {0}",
    entries[0].get_MachineName());
Console.WriteLine("entries[0].Label: {0}",
    entries[0].get_Label());
Console.WriteLine("entries[0].Category: {0}",
    entries[0].get_Category().ToString());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
MessageQueuePermissionEntryCollection クラス
MessageQueuePermissionEntryCollection メンバ
System.Messaging 名前空間