MessageQueuePermission 類別

參考

定義

命名空間:: System.Messaging

組件:: System.Messaging.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

允許控制訊息處理的程式碼存取使用權限。

public ref class MessageQueuePermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission

[System.Serializable]
public sealed class MessageQueuePermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[<System.Serializable>]
type MessageQueuePermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class MessageQueuePermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

繼承: Object

CodeAccessPermission
MessageQueuePermission

屬性: SerializableAttribute

實作: IUnrestrictedPermission

範例

下列程式代碼範例會建立數個實例 MessageQueuePermission ，並示範屬性的使用 PermissionEntries 。


using System;
using System.Messaging;

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

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

        // Demonstrate MessageQueuePermission's constructors.
        example.CreatePermission1();
        example.CreatePermission2();
        example.CreatePermission3();
        example.CreatePermission4();
        example.CreatePermission5();

        // Get and set MessageQueuePermission's PermissionEntries property.
        example.GetPermissionEntries();
    }

    // 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 following MessageQueuePermission constructor:
    // public #ctor ()
    public void CreatePermission1()
    {
        // Create a new instance of MessageQueuePermission.
        MessageQueuePermission permission = new MessageQueuePermission();
    }

    // Demonstrates the following MessageQueuePermission constructor:
    // public #ctor (MessageQueuePermissionAccess permissionAccess,
    //  String path)
    public void CreatePermission2()
    {
        // Create a new instance of MessageQueuePermission.
        MessageQueuePermission permission = new MessageQueuePermission(
            MessageQueuePermissionAccess.Receive,
            ".\\exampleQueue");
    }

    // Demonstrates the following MessageQueuePermission constructor:
    // public #ctor (MessageQueuePermissionAccess permissionAccess,
    //  String machineName, String label, String category)
    public void CreatePermission3()
    {
        // Connect to a queue on the local computer.
        MessageQueue queue = new MessageQueue(".\\exampleQueue");

        // Create a new instance of MessageQueuePermission.
    string queueCategory = queue.Category.ToString();
    string machineName = queue.MachineName;
    string label = queue.Label;
        MessageQueuePermission permission = new MessageQueuePermission(
            MessageQueuePermissionAccess.Receive,
            machineName,
            label,
            queueCategory);
    }

    // Demonstrates the following MessageQueuePermission constructor:
    //public #ctor (MessageQueuePermissionEntry[] permissionAccessEntries)
    public void CreatePermission4()
    {
        // Connect to a queue on the local computer.
        MessageQueue queue = new MessageQueue(".\\exampleQueue");

        // Create an array of type MessageQueuePermissionEntry.
        MessageQueuePermissionEntry[] entries =
            new MessageQueuePermissionEntry[1];

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

        // Create a new instance of MessageQueuePermission.
        MessageQueuePermission permission = new MessageQueuePermission(
            entries);
    }

    // Demonstrates the following MessageQueuePermission constructor:
    //public #ctor (PermissionState state)
    public void CreatePermission5()
    {
        // Create a new instance of MessageQueuePermission.
        MessageQueuePermission permission = new MessageQueuePermission(
            System.Security.Permissions.PermissionState.Unrestricted);
    }

    public void GetPermissionEntries()
    {
    
        // Connect to a queue on the local computer.
        MessageQueue queue = new MessageQueue(".\\exampleQueue");

        // Create an array of type MessageQueuePermissionEntry.
        MessageQueuePermissionEntry[] entries =
            new MessageQueuePermissionEntry[1];

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

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

        // Create a new instance of MessageQueuePermissionEntryCollection and
        // use it to retrieve the permission's PermissionEntries property
        // value.
        MessageQueuePermissionEntryCollection collection =
            permission.PermissionEntries;

        // Loop through the collection.
        foreach(MessageQueuePermissionEntry entry in collection)
        {
            // Display the property values of each MessageQueuePermissionEntry.
            Console.WriteLine("PermissionAccess: {0}", entry.PermissionAccess);
            Console.WriteLine("MachineName: {0}", entry.MachineName);
            Console.WriteLine("Label: {0}", entry.Label);
            Console.WriteLine("Category: {0}", entry.Category.ToString());
        }
    }
}

建構函式

MessageQueuePermission()	初始化 MessageQueuePermission 類別的新執行個體。
MessageQueuePermission(MessageQueuePermissionAccess, String)	使用指定的存取等級和佇列路徑，初始化 MessageQueuePermission 類別的新執行個體。
MessageQueuePermission(MessageQueuePermissionAccess, String, String, String)	使用指定的存取等級、要使用的電腦、佇列描述和佇列分類，初始化 MessageQueuePermission 類別的新執行個體。
MessageQueuePermission(MessageQueuePermissionEntry[])	使用指定的使用權限存取等級項目，初始化 MessageQueuePermission 類別的新執行個體。
MessageQueuePermission(PermissionState)	使用指定權限狀態，初始化 MessageQueuePermission 類別的新執行個體。

屬性

PermissionEntries

取得這個使用權限要求的使用權限項目的集合。

方法

Assert()	宣告即使堆疊中較高層的呼叫端未獲得資源存取權限，呼叫程式碼仍可透過呼叫這個方法的程式碼要求權限，來存取受保護的資源。使用 Assert() 會造成安全性問題。 (繼承來源 CodeAccessPermission)
Copy()	建立並傳回目前使用權限物件的相同複本。
Demand()	如果在呼叫堆疊中較高的所有呼叫端都尚未被授與由目前執行個體所指定之權限，則會在執行階段強制執行 SecurityException。 (繼承來源 CodeAccessPermission)
Deny()	已淘汰. 已淘汰. 防止呼叫堆疊中較高的呼叫端，使用程式碼呼叫此方法來存取目前執行個體所指定的資源。 (繼承來源 CodeAccessPermission)
Equals(Object)	判斷指定的 CodeAccessPermission 物件是否等於目前的 CodeAccessPermission。 (繼承來源 CodeAccessPermission)
FromXml(SecurityElement)	透過 XML 編碼，重新建構具有指定狀態的安全性物件。
GetHashCode()	取得 CodeAccessPermission 物件的雜湊碼，其適合用於雜湊表這類的雜湊演算法和資料結構。 (繼承來源 CodeAccessPermission)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Intersect(IPermission)	傳回新使用權限物件，表示目前使用權限物件和指定使用權限物件的交集。
IsSubsetOf(IPermission)	傳回值，指出目前的使用權限物件是否為指定使用權限物件的子集。
IsUnrestricted()	傳回值，指出使用權限是否可以表示為不暸解使用權限語意 (Semantics) 而不受限制。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
PermitOnly()	防止呼叫堆疊中較高的呼叫端，使用程式碼呼叫此方法來存取目前執行個體所指定之資源以外的所有資源。 (繼承來源 CodeAccessPermission)
ToString()	建立並傳回目前權限物件的字串表示。 (繼承來源 CodeAccessPermission)
ToXml()	建立安全物件及其目前狀態的 XML 編碼方式。
Union(IPermission)	傳回新的使用權限物件，這個物件是目前和指定使用權限物件的聯集。

適用於

共用方式為

MessageQueuePermission 類別

定義

範例

建構函式

屬性

方法

適用於

另請參閱

其他資源