SecurityException Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die Ausnahme, die ausgelöst wird, wenn ein Sicherheitsfehler erkannt wird.
public ref class SecurityException : Exception
public ref class SecurityException : SystemException
public class SecurityException : Exception
[System.Serializable]
public class SecurityException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class SecurityException : SystemException
public class SecurityException : SystemException
type SecurityException = class
inherit Exception
[<System.Serializable>]
type SecurityException = class
inherit SystemException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SecurityException = class
inherit SystemException
type SecurityException = class
inherit SystemException
Public Class SecurityException
Inherits Exception
Public Class SecurityException
Inherits SystemException
- Vererbung
- Vererbung
- Attribute
Hinweise
Eine SecurityException Ausnahme wird ausgelöst, wenn ein Aufrufer nicht über die erforderlichen Berechtigungen für den Zugriff auf eine Ressource verfügt. Im folgenden Beispiel wird ein Objekt instanziiert, das ein PermissionSetUIPermission Objekt enthält, um den Zugriff auf UI-Objekte und die Zwischenablage und ein RegistryPermission Objekt zu ermöglichen, um den Registrierungszugriff zu verhindern. Der Aufruf der PermissionSet.PermitOnly Methode bedeutet, dass diese Berechtigungen unabhängig von den Berechtigungen gelten, die dem Aufrufer zugewiesen sind. Daher löst der Versuch, einen Registrierungsschlüssel zu erstellen, einen SecurityException.
using Microsoft.Win32;
using System;
using System.Security;
using System.Security.Permissions;
public class Example
{
public static void Main()
{
PermissionSet perms = new PermissionSet(null);
perms.AddPermission(new UIPermission(PermissionState.Unrestricted));
perms.AddPermission(new RegistryPermission(PermissionState.None));
perms.PermitOnly();
try {
RegistryKey key = Registry.CurrentUser.CreateSubKey("MyCompany\\Applications");
Console.WriteLine("Registry key: {0}", key.Name);
}
catch (SecurityException e) {
Console.WriteLine("Security Exception:\n\n{0}", e.Message);
}
}
}
// The example displays the following output:
// Security Exception:
//
// Request for the permission of type 'System.Security.Permissions.RegistryPermission,
// mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' failed.
Imports Microsoft.Win32
Imports System.Security
Imports System.Security.Permissions
Module Example
Public Sub Main()
Dim perms As New PermissionSet(CType(Nothing, PermissionSet))
perms.AddPermission(New UIPermission(PermissionState.Unrestricted))
perms.AddPermission(New RegistryPermission(PermissionState.None))
perms.PermitOnly()
Try
Dim key As RegistryKey = Registry.CurrentUser.CreateSubKey("MyCompany\\Applications")
Console.WriteLine("Registry key: {0}", key.Name)
Catch e As SecurityException
Console.WriteLine("Security Exception:\n\n{0}", e.Message)
End Try
End Sub
End Module
' The example displays the following output:
' Security Exception:
'
' Request for the permission of type 'System.Security.Permissions.RegistryPermission,
' mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' failed.
SecurityException verwendet die HRESULT-COR_E_SECURITY, die den Wert 0x8013150A hat.
Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz der SecurityException Klasse finden Sie unter einem bestimmten SecurityException Konstruktor.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SecurityException() |
Initialisiert eine neue Instanz der SecurityException Klasse mit Standardeigenschaften. |
| SecurityException(SerializationInfo, StreamingContext) |
Initialisiert eine neue Instanz der SecurityException Klasse mit serialisierten Daten. |
| SecurityException(String, AssemblyName, PermissionSet, PermissionSet, MethodInfo, SecurityAction, Object, IPermission, Evidence) |
Initialisiert eine neue Instanz der SecurityException Klasse für eine Ausnahme, die durch einen unzureichenden Grant-Satz verursacht wird. |
| SecurityException(String, Exception) |
Initialisiert eine neue Instanz der SecurityException Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die die Ursache dieser Ausnahme ist. |
| SecurityException(String, Object, Object, MethodInfo, Object, IPermission) |
Initialisiert eine neue Instanz der SecurityException Klasse für eine Ausnahme, die durch einen Deny auf dem Stapel verursacht wird. |
| SecurityException(String, Type, String) |
Initialisiert eine neue Instanz der SecurityException Klasse mit einer angegebenen Fehlermeldung, dem Berechtigungstyp, der die Ausnahme ausgelöst hat, und den Berechtigungsstatus. |
| SecurityException(String, Type) |
Initialisiert eine neue Instanz der SecurityException Klasse mit einer angegebenen Fehlermeldung und dem Berechtigungstyp, der dazu führte, dass die Ausnahme ausgelöst wurde. |
| SecurityException(String) |
Initialisiert eine neue Instanz der SecurityException Klasse mit einer angegebenen Fehlermeldung. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Action |
Ruft die Sicherheitsaktion ab, die die Ausnahme verursacht hat, oder legt sie fest. |
| Data |
Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception) |
| Demanded |
Ruft die angeforderte Sicherheitsberechtigung, Berechtigungssatz oder Berechtigungssatzsammlung ab, die fehlgeschlagen ist, oder legt sie fest. |
| DenySetInstance |
Ruft die verweigerte Sicherheitsberechtigung, Berechtigungssatz oder Berechtigungssatzsammlung ab, die zu einem Fehler führte, oder legt sie fest. |
| FailedAssemblyInfo |
Ruft Informationen zur fehlgeschlagenen Assembly ab oder legt diese fest. |
| FirstPermissionThatFailed |
Dient zum Abrufen oder Festlegen der ersten Berechtigung in einer Berechtigungssatz- oder Berechtigungssatzsammlung, bei der die Anforderung fehlgeschlagen ist. |
| GrantedSet |
Ruft den gewährten Berechtigungssatz der Assembly ab, die dies SecurityExceptionverursacht hat, oder legt diesen fest. |
| HelpLink |
Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception) |
| HResult |
Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception) |
| InnerException |
Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception) |
| Message |
Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception) |
| Method |
Dient zum Abrufen oder Festlegen der Informationen zur Methode, die der Ausnahme zugeordnet ist. |
| PermissionState |
Dient zum Abrufen oder Festlegen des Status der Berechtigung, die die Ausnahme ausgelöst hat. |
| PermissionType |
Dient zum Abrufen oder Festlegen des Typs der Berechtigung, die fehlgeschlagen ist. |
| PermitOnlySetInstance |
Dient zum Abrufen oder Festlegen der Berechtigungs-, Berechtigungssatz- oder Berechtigungssatzsammlung, die Teil des schreibgeschützten Stapelframes ist, der dazu führte, dass eine Sicherheitsüberprüfung fehlschlug. |
| RefusedSet |
Ruft den abgelehnten Berechtigungssatz der Assembly ab, die dies SecurityExceptionverursacht hat, oder legt diesen fest. |
| Source |
Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception) |
| StackTrace |
Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception) |
| TargetSite |
Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception) |
| Url |
Ruft die URL der Assembly ab, die die Ausnahme verursacht hat, oder legt sie fest. |
| Zone |
Ruft die Zone der Assembly ab, die die Ausnahme verursacht hat, oder legt sie fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBaseException() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Legt die SerializationInfo mit Informationen über die SecurityException. |
| GetType() |
Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Darstellung der aktuellen SecurityExceptionzurück. |
Ereignisse
| Name | Beschreibung |
|---|---|
| SerializeObjectState |
Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception) |