SecurityState Klasse

Definition

Namespace:

System.Security

Assembly:

System.Security.Permissions.dll

Paket:

System.Security.Permissions v9.0.0-preview.3.24172.9

Quelle:

SecurityState.cs

Stellt eine Basisklasse zum Anfordern des Sicherheitsstatus einer Aktion aus dem AppDomainManager-Objekt bereit.

public ref class SecurityState abstract

public abstract class SecurityState

type SecurityState = class

Public MustInherit Class SecurityState

Vererbung

Object

SecurityState

Abgeleitet

System.IO.IsolatedStorage.IsolatedStorageSecurityState

Beispiele

Das folgende Beispiel zeigt, wie die -Klasse überschrieben SecurityState wird.

[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");  
    }  
}    

Hinweise

Sie müssen von dieser Klasse erben, um eine Klasse bereitzustellen, die eine -Eigenschaft enthält, die die auszuführende sicherheitsrelevante Aktion angibt. Das SecurityState Objekt, das aus der abgeleiteten Klasse instanziiert wird, wird an die AppDomainManager.CheckSecuritySettings -Methode übergeben, um zu bestimmen, ob der Host die Ausführung dieser Aktion zulässt. Die Standardimplementierung der CheckSecuritySettings -Methode gibt immer zurück false. Die -Methode muss überschrieben werden, um die zulässigen Aktionen zu erkennen.

Wenn Sie beispielsweise auf eine Webkamera in Ihrem Bibliothekscode zugreifen möchten, erstellen Sie ein WebcamSecurityState Objekt und rufen die EnsureState -Methode auf, um zu bestimmen, ob der Host den Zugriff auf die Webkamera zulässt, wie im folgenden Beispiel gezeigt. (Den Code für WebcamSecurityState finden Sie im Abschnitt "Beispiel".)

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);  
}  

Zum Verarbeiten des Aufrufs WebcamSecurityState muss durch AppDomainManager eine Außerkraftsetzung der AppDomainManager.CheckSecuritySettings -Methode darauf hingewiesen werden, wie im folgenden Beispiel gezeigt.

[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;  
}   

Konstruktoren

SecurityState()

Initialisiert eine neue Instanz der SecurityState-Klasse.

Methoden

EnsureState()	Stellt beim Überschreiben in einer abgeleiteten Klasse sicher, dass der von SecurityState dargestellte Zustand auf dem Host verfügbar ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsStateAvailable()	Ruft einen Wert ab, der angibt, ob der Zustand für diese Implementierung der SecurityState-Klasse auf dem aktuellen Host verfügbar ist.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)