SecurityException Classe

Definição

A exceção que é lançada quando é detetado um erro de segurança.

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

Observações

É lançada uma SecurityException exceção quando um chamador não tem as permissões necessárias para aceder a um recurso. O exemplo seguinte instancia um PermissionSet objeto que inclui um UIPermission objeto para permitir o acesso a objetos da interface e à Área de Transferência e um RegistryPermission objeto para impedir o acesso ao registo. A chamada ao PermissionSet.PermitOnly método significa que estas permissões se aplicam independentemente das permissões atribuídas ao chamador. Como resultado, a tentativa de criar uma chave de registo 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 utiliza o COR_E_SECURITY HRESULT, que tem o valor 0x8013150A.

Para uma lista dos valores iniciais das propriedades de uma instância da SecurityException classe, veja um construtor específico SecurityException .

Construtores

Name Description
SecurityException()

Inicializa uma nova instância da SecurityException classe com propriedades por defeito.

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 um Negado na pilha.

SecurityException(String, Type, String)

Inicializa uma nova instância da SecurityException classe com uma mensagem de erro especificada, o tipo de permissão que causou o lançamento 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 o lançamento da exceção.

SecurityException(String)

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

Propriedades

Name Description
Action

Recebe 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ção adicional definida pelo utilizador 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 permissões que falhou.

DenySetInstance

Recebe ou define a permissão de segurança negada, o conjunto de permissões ou a coleção do conjunto de permissões que causou a falha de uma exigência.

FailedAssemblyInfo

Obtém ou define informação sobre a montagem falhada.

FirstPermissionThatFailed

Recebe ou define a primeira permissão num conjunto de permissões ou coleção de conjuntos de permissões que falhou à exigência.

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 ficheiro de ajuda associado a esta exceção.

(Herdado de Exception)
HResult

Recebe 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

Recebe uma mensagem que descreve a exceção atual.

(Herdado de Exception)
Method

Obtém ou define a informação sobre o método associado à exceção.

PermissionState

Obtém ou define o estado da permissão que lançou a exceção.

PermissionType

Recebe ou define o tipo de permissão que falhou.

PermitOnlySetInstance

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

RefusedSet

Obtém ou define o conjunto de permissões recusadas da montagem que causou o SecurityException.

Source

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

(Herdado de Exception)
StackTrace

Obtém uma representação string dos frames imediatos na stack de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que lança a exceção atual.

(Herdado de Exception)
Url

Obtém ou define a URL da assembly que causou a exceção.

Zone

Obtém ou define a zona do conjunto que causou a exceção.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Define o SerializationInfo com informação sobre o SecurityException.

GetType()

Obtém o tipo de execução da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma representação do atual SecurityException.

evento

Name 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

Ver também