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
[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
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 para o 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

Nome Description
SecurityException()

Inicializa uma nova instância da SecurityException classe com propriedades padrão.

SecurityException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da SecurityException classe com dados serializados.

SecurityException(String, AssemblyName, PermissionSet, PermissionSet, MethodInfo, SecurityAction, Object, IPermission, Evidence)

Inicializa uma nova instância da SecurityException classe para uma exceção causada por um conjunto de concessões insuficiente.

SecurityException(String, Exception)

Inicializa uma nova instância da SecurityException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.

SecurityException(String, Object, Object, MethodInfo, Object, IPermission)

Inicializa uma nova instância da SecurityException classe para uma exceção causada por uma Negação na pilha.

SecurityException(String, Type, String)

Inicializa uma nova instância da classe com uma mensagem de SecurityException erro especificada, o tipo de permissão que causou a geração da exceção e o estado de permissão.

SecurityException(String, Type)

Inicializa uma nova instância da SecurityException classe com uma mensagem de erro especificada e o tipo de permissão que causou a geração da exceção.

SecurityException(String)

Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada.

Propriedades

Nome Description
Action

Obtém ou define a ação de segurança que causou a exceção.

Data

Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.

(Herdado de Exception)
Demanded

Obtém ou define a permissão de segurança exigida, o conjunto de permissões ou a coleção de conjuntos de permissões que falhou.

DenySetInstance

Obtém ou define a permissão de segurança negada, o conjunto de permissões ou a coleção de conjuntos de permissões que causou uma falha na demanda.

FailedAssemblyInfo

Obtém ou define informações sobre o assembly com falha.

FirstPermissionThatFailed

Obtém ou define a primeira permissão em um conjunto de permissões ou coleção de conjuntos de permissões que falhou na demanda.

GrantedSet

Obtém ou define o conjunto de permissões concedido 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 atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a Exception instância 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 da permissão que falhou.

PermitOnlySetInstance

Obtém ou define a permissão, o conjunto de permissões ou a coleção de conjuntos de permissões que faz parte do quadro de pilha somente permissão que causou falha na verificação de segurança.

RefusedSet

Obtém ou define o conjunto de permissões recusado do assembly que causou o SecurityException.

Source

Obtém ou define o nome do aplicativo ou do objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que gera 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

Nome Description
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 causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Define o SerializationInfo com informações sobre o SecurityException.

GetType()

Obtém o tipo de runtime da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma representação do atual SecurityException.

Eventos

Nome Description
SerializeObjectState

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