SecurityException Classe

Definição

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
SecurityException
Herança
SecurityException
Atributos

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

Confira também