MessageQueuePermissionAccess 列挙体

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

MessageQueuePermissionAccess 列挙体

System.Messaging アクセス許可クラスによって使用されるアクセス レベルを定義します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

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

Visual Basic (宣言)

<SerializableAttribute> _
<FlagsAttribute> _
Public Enumeration MessageQueuePermissionAccess

Visual Basic (使用法)

Dim instance As MessageQueuePermissionAccess

C#

[SerializableAttribute] 
[FlagsAttribute] 
public enum MessageQueuePermissionAccess

C++

[SerializableAttribute] 
[FlagsAttribute] 
public enum class MessageQueuePermissionAccess

J#

/** @attribute SerializableAttribute() */ 
/** @attribute FlagsAttribute() */ 
public enum MessageQueuePermissionAccess

JScript

SerializableAttribute 
FlagsAttribute 
public enum MessageQueuePermissionAccess

メンバ

	メンバ名	説明
	Administer	MessageQueue が使用できるキューを参照し、キューの中のメッセージを読み取り、メッセージの送受信を行います。
	Browse	MessageQueue が使用できるキューを参照します。
	None	MessageQueue にはアクセス許可がありません。
	Peek	MessageQueue が使用できるキューを参照し、キューの中のメッセージを読み取ります。
	Receive	MessageQueue が使用できるキューを参照し、キューの中のメッセージを読み取り、メッセージの送受信を行います。
	Send	MessageQueue が使用できるキューを参照し、メッセージを送信します。

使用例

MessageQueuePermissionAccess を使用して MessageQueuePermission の新しいインスタンスを作成するコード例を次に示します。

C#

using System;
using System.Messaging;

public class MessageQueuePermissionAccessExample
{
    public static void Main()
    {
        // Create a new instance of the class.
        MessageQueuePermissionAccessExample example =
            new MessageQueuePermissionAccessExample();

        // Create a non-transactional queue on the local computer.
        CreateQueue(".\\exampleQueue", false);

        // Demonstrate use of MessageQueuePermissionAccess.
        example.CreatePermission();
    }

    // Creates a new queue.
    public static void CreateQueue(string
 queuePath, bool transactional)
    {
        if(!MessageQueue.Exists(queuePath))
        {
            MessageQueue.Create(queuePath, transactional);
        }
        else
        {
            Console.WriteLine(queuePath + " already exists.");
        }
    }

    // Demonstrates the use of MessageQueuePermissionAccess
    public void CreatePermission()
    {
        // Connect to a queue on the local computer.
        MessageQueue queue = new MessageQueue(".\\exampleQueue");
    string machineName = queue.MachineName;
    string label = queue.Label;
        string category = queue.Category.ToString();
        // Create a new instance of MessageQueuePermission.
        MessageQueuePermission permission = new MessageQueuePermission(
            MessageQueuePermissionAccess.Receive,
            machineName,
            label,
            category);
    }
}

C++

#using <System.dll>
#using <System.Messaging.dll>

using namespace System;
using namespace System::Messaging;

// Creates a new queue.
void CreateQueue(String^ queuePath, bool transactional)
{
    if (!MessageQueue::Exists(queuePath))
    {
        MessageQueue^ queue = MessageQueue::Create(queuePath, transactional);
        queue->Close();       
    }
    else
    {
        Console::WriteLine("{0} already exists.",queuePath);
    }
}

// Demonstrates the use of MessageQueuePermissionAccess
void CreatePermission()
{
    // Connect to a queue on the local computer.
    MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

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

    queue->Close();
}

int main()
{
    try
    {

        // Create a non-transactional queue on the local computer.
        CreateQueue(".\\exampleQueue", false);

        // Demonstrate use of MessageQueuePermissionAccess.
        CreatePermission();
    }

    catch (InvalidOperationException^)
    {
        Console::WriteLine("Please install Message Queuing.");
    }

    catch (MessageQueueException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
System.Messaging 名前空間
MessageQueuePermission クラス
MessageQueuePermissionAttribute
MessageQueuePermissionEntry
MessageQueuePermissionEntryCollection