SecurityState Класс

Определение

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

System.Security

Сборка:

System.Security.Permissions.dll

Пакет:

System.Security.Permissions v11.0.0-preview.4.26230.115

Исходный код:

SecurityState.cs

Предоставляет базовый класс для запроса состояния безопасности действия из AppDomainManager объекта.

public ref class SecurityState abstract

public abstract class SecurityState

type SecurityState = class

Public MustInherit Class SecurityState

Наследование

Object

SecurityState

Производный

System.IO.IsolatedStorage.IsolatedStorageSecurityState

Примеры

В следующем примере показано, как переопределить SecurityState класс.

[SecurityCritical]
public enum WebcamSecurityOptions
{
    SafeAccess,
    FullAccess
}
[SecurityCritical]
public class WebcamSecurityState : SecurityState
{
    public WebcamSecurityState(string description, WebcamSecurityOptions options)
    {
        Options = options;
        Description = description;
    }
    public WebcamSecurityOptions Options { get; set; }
    public string Description { get; set; }
    public override void EnsureState()
    {
        if (!IsStateAvailable())
            throw new ApplicationException("WebcamSecurityState not available");
    }
}

Комментарии

Необходимо наследовать от этого класса, чтобы предоставить класс, содержащий свойство, указывающее выполняемое действие с учетом безопасности. Объект SecurityState , созданный из производного класса, передается AppDomainManager.CheckSecuritySettings методу, чтобы определить, позволяет ли узел выполнять это действие. Реализация метода по умолчанию CheckSecuritySettings всегда возвращается false. Для обнаружения разрешенных действий необходимо переопределить метод.

Например, если вы хотите получить доступ к веб-камере в коде библиотеки, создайте WebcamSecurityState объект и вызовите EnsureState метод, чтобы определить, разрешает ли узел доступ к веб-камере, как показано в следующем примере. (Код можно найти WebcamSecurityState в разделе "Пример".

var securityState = new WebcamSecurityState("Safe access to Webcam", WebcamSecurityOptions.SafeAccess);
try
{
    securityState.EnsureState();
    // Allocate memory.
}
catch (ApplicationException e)
{
    // Handle any exception that is thrown.
    System.Diagnostics.Debug.WriteLine(e.Message);
}

Чтобы обработать вызов, AppDomainManager необходимо учитывать WebcamSecurityState с помощью переопределения AppDomainManager.CheckSecuritySettings метода, как показано в следующем примере.

[SecurityCritical]
public override bool CheckSecuritySettings(System.Security.SecurityState securityState)
{
    switch (securityState.ToString())
    {
        case "WebcamSecurityState":
        {
            if ((securityState as WebcamSecurityState).Options == WebcamSecurityOptions.SafeAccess)
                return PromptUser((securityState as WebcamSecurityState).Description);
            return false;
        }
    }
    return false;
}
private bool PromptUser(string text)
{
    // Replace the OpenFileDialog with a custom user prompt.
    OpenFileDialog o = new OpenFileDialog();
    o.Title = text;
    if (o.ShowDialog() == DialogResult.OK)
        return true;
    else
        return false;
}

Конструкторы

Имя	Описание
SecurityState()	Инициализирует новый экземпляр класса SecurityState.

Методы

Имя	Описание
EnsureState()	При переопределении в производном классе убедитесь, что состояние, представленное SecurityState на узле, доступно.
IsStateAvailable()	Возвращает значение, указывающее, доступно ли состояние для этой реализации SecurityState класса на текущем узле.