MessageQueuePermission Класс

Ссылка

Определение

Пространство имен:: System.Messaging

Сборка:: System.Messaging.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Позволяет контролировать разрешения на доступ к коду для обмена сообщениями.

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()	Возвращает значение, указывающее, может ли разрешение быть представлено как неограниченное без знания его семантики.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
PermitOnly()	Запрещает вызывающим объектам выше в стеке вызовов использовать код, который вызывает этот метод для доступа ко всем ресурсам, за исключением ресурса, указанного текущим экземпляром. (Унаследовано от CodeAccessPermission)
ToString()	Создает и возвращает строковое представление текущего объекта разрешения. (Унаследовано от CodeAccessPermission)
ToXml()	Создает кодировку XML для объекта безопасности и его текущего состояния.
Union(IPermission)	Возвращает новый объект разрешений, представляющий собой объединение текущего и заданного объектов разрешений.

Применяется к