SecurityException Classe

Referência

Definição

Namespace:: System.Security

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A exceção gerada quando um erro de segurança é detectado.

public ref class SecurityException : Exception

public ref class SecurityException : SystemException

public class SecurityException : Exception

public class SecurityException : SystemException

[System.Serializable]
public class SecurityException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class SecurityException : SystemException

type SecurityException = class
    inherit Exception

type SecurityException = class
    inherit SystemException

[<System.Serializable>]
type SecurityException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SecurityException = class
    inherit SystemException

Public Class SecurityException
Inherits Exception

Public Class SecurityException
Inherits SystemException

Herança: Object

Exception
SecurityException

Herança: Object

Exception

SystemException
SecurityException

Atributos: SerializableAttribute ComVisibleAttribute

Comentários

Uma SecurityException exceção é gerada quando um chamador não tem as permissões necessárias para acessar um recurso. O exemplo a seguir cria uma instância de um PermissionSet objeto que inclui um UIPermission objeto para permitir o acesso a objetos de interface do usuário e a área de transferência e um RegistryPermission objeto para impedir o acesso ao Registro. A chamada ao PermissionSet.PermitOnly método significa que essas permissões serão aplicadas independentemente das permissões atribuídas ao chamador. Como resultado, a tentativa de criar uma chave do Registro gera um 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 usa o COR_E_SECURITY HRESULT, que tem o valor 0x8013150A.

Para obter uma lista dos valores de propriedade iniciais de uma instância da SecurityException classe, consulte um construtor específico SecurityException .

Construtores

SecurityException()	Inicializa uma nova instância da classe SecurityException com propriedades padrão.
SecurityException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe SecurityException com dados serializados.
SecurityException(String)	Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada.
SecurityException(String, AssemblyName, PermissionSet, PermissionSet, MethodInfo, SecurityAction, Object, IPermission, Evidence)	Inicializa uma nova instância da classe SecurityException para uma exceção causada por um conjunto de concessões insuficiente.
SecurityException(String, Exception)	Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
SecurityException(String, Object, Object, MethodInfo, Object, IPermission)	Inicializa uma nova instância da classe SecurityException para uma exceção causada por uma Negação na pilha.
SecurityException(String, Type)	Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada e o tipo de permissão que fez a exceção ser gerada.
SecurityException(String, Type, String)	Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada, o tipo de permissão que fez a exceção ser gerada e o estado da permissão.

Propriedades

Action	Obtém ou define a ação de segurança que causou a exceção.
Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
Demanded	Obtém ou define a permissão de segurança, o conjunto de permissões ou a coleção do conjunto de permissão necessário que falhou.
DenySetInstance	Obtém ou define a permissão de segurança, o conjunto de permissões ou a coleção do conjunto de permissões negado que causou a falha de uma demanda.
FailedAssemblyInfo	Obtém ou define as informações sobre o assembly com falha.
FirstPermissionThatFailed	Obtém ou define a primeira permissão em um conjunto de permissões ou de uma coleção de conjuntos de permissão que causou a falha da demanda.
GrantedSet	Obtém ou define o conjunto de permissões concedidas do assembly que causou o SecurityException.
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Method	Obtém ou define as informações sobre o método associado à exceção.
PermissionState	Obtém ou define o estado da permissão que gerou a exceção.
PermissionType	Obtém ou define o tipo de permissão que falhou.
PermitOnlySetInstance	Obtém ou define a permissão, o conjunto de permissões ou a coleção do conjunto de permissões que faz parte do registro de ativação somente permissão que causou a falha de uma verificação de segurança.
RefusedSet	Obtém ou define o conjunto de permissões recusadas do assembly que causou o SecurityException.
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)
Url	Obtém ou define a URL do assembly que causou a exceção.
Zone	Obtém ou define a zona do assembly que causou a exceção.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Define SerializationInfo com informações sobre SecurityException.
GetObjectData(SerializationInfo, StreamingContext)	Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception)
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma representação do SecurityException atual.

Eventos

SerializeObjectState

Obsoleto.

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.

(Herdado de Exception)

Aplica-se a

Partilhar via