SecurityException Classe

Definição

A exceção que é gerada quando um erro de segurança é detectado.The exception that is thrown when a security error is detected.

public ref class SecurityException : SystemException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class SecurityException : SystemException
type SecurityException = class
    inherit SystemException
Public Class SecurityException
Inherits SystemException
Herança
SecurityException
Atributos

Comentários

Uma SecurityException exceção é lançada quando um chamador não tem as permissões necessárias para acessar um recurso.A SecurityException exception is thrown when a caller does not have the permissions required to access a resource. O exemplo a seguir instancia um PermissionSet objeto que inclui um UIPermission objeto para permitir o acesso a objetos de interface do usuário e RegistryPermission a área de transferência e um objeto para impedir o acesso ao registro.The following example instantiates a PermissionSet object that includes a UIPermission object to allow access to UI objects and the Clipboard and a RegistryPermission object to prevent registry access. A chamada para o PermissionSet.PermitOnly método significa que essas permissões serão aplicadas independentemente das permissões atribuídas ao chamador.The call to the PermissionSet.PermitOnly method means that these permissions will apply regardless of the permissions assigned to the caller. Como resultado, a tentativa de criar uma chave do registro gera um SecurityException.As a result, the attempt to create a registry key throws a 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.

SecurityExceptionusa o HRESULT COR_E_SECURITY, que tem o valor 0x8013150A.SecurityException uses the HRESULT COR_E_SECURITY, which has the value 0x8013150A.

Para obter uma lista dos valores de propriedade inicial para uma instância da SecurityException classe, consulte um construtor SecurityException específico.For a list of the initial property values for an instance of the SecurityException class, see a specific SecurityException constructor.

Construtores

SecurityException()

Inicializa uma nova instância da classe SecurityException com propriedades padrão.Initializes a new instance of the SecurityException class with default properties.

SecurityException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe SecurityException com dados serializados.Initializes a new instance of the SecurityException class with serialized data.

SecurityException(String)

Inicializa uma nova instância da classe SecurityException com uma mensagem de erro especificada.Initializes a new instance of the SecurityException class with a specified error message.

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.Initializes a new instance of the SecurityException class for an exception caused by an insufficient grant set.

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.Initializes a new instance of the SecurityException class with a specified error message and a reference to the inner exception that is the cause of this exception.

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.Initializes a new instance of the SecurityException class for an exception caused by a Deny on the stack.

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.Initializes a new instance of the SecurityException class with a specified error message and the permission type that caused the exception to be thrown.

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.Initializes a new instance of the SecurityException class with a specified error message, the permission type that caused the exception to be thrown, and the permission state.

Propriedades

Action

Obtém ou define a ação de segurança que causou a exceção.Gets or sets the security action that caused the exception.

Data

Obtém uma coleção de pares de chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(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.Gets or sets the demanded security permission, permission set, or permission set collection that failed.

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.Gets or sets the denied security permission, permission set, or permission set collection that caused a demand to fail.

FailedAssemblyInfo

Obtém ou define as informações sobre o assembly com falha.Gets or sets information about the failed assembly.

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.Gets or sets the first permission in a permission set or permission set collection that failed the demand.

GrantedSet

Obtém ou define o conjunto de permissões concedidas do assembly que causou o SecurityException.Gets or sets the granted permission set of the assembly that caused the SecurityException.

HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.Gets or sets a link to the help file associated with this exception.

(Herdado de Exception)
HResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Herdado de Exception)
InnerException

Obtém a instância Exception que causou a exceção atual.Gets the Exception instance that caused the current exception.

(Herdado de Exception)
Message

Obtém uma mensagem que descreve a exceção atual.Gets a message that describes the current exception.

(Herdado de Exception)
Method

Obtém ou define as informações sobre o método associado à exceção.Gets or sets the information about the method associated with the exception.

PermissionState

Obtém ou define o estado da permissão que gerou a exceção.Gets or sets the state of the permission that threw the exception.

PermissionType

Obtém ou define o tipo de permissão que falhou.Gets or sets the type of the permission that failed.

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.Gets or sets the permission, permission set, or permission set collection that is part of the permit-only stack frame that caused a security check to fail.

RefusedSet

Obtém ou define o conjunto de permissões recusadas do assembly que causou o SecurityException.Gets or sets the refused permission set of the assembly that caused the SecurityException.

Source

Obtém ou define o nome do aplicativo ou objeto que causa o erro.Gets or sets the name of the application or the object that causes the error.

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.Gets a string representation of the immediate frames on the call stack.

(Herdado de Exception)
TargetSite

Obtém o método que gerou a exceção atual.Gets the method that throws the current exception.

(Herdado de Exception)
Url

Obtém ou define a URL do assembly que causou a exceção.Gets or sets the URL of the assembly that caused the exception.

Zone

Obtém ou define a zona do assembly que causou a exceção.Gets or sets the zone of the assembly that caused the exception.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(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.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Define SerializationInfo com informações sobre SecurityException.Sets the SerializationInfo with information about the SecurityException.

GetType()

Obtém o tipo de tempo de execução da instância atual.Gets the runtime type of the current instance.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma representação do SecurityException atual.Returns a representation of the current SecurityException.

Eventos

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.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Herdado de Exception)

Aplica-se a

Veja também