CodeAccessPermission.IsSubsetOf(IPermission) Método

Definição

Espaço de Nomes:
System.Security
Assemblagem:
mscorlib.dll

Quando implementado por uma classe derivada, determina se a permissão atual é um subconjunto da permissão especificada.

public:
 abstract bool IsSubsetOf(System::Security::IPermission ^ target);
public abstract bool IsSubsetOf(System.Security.IPermission target);
abstract member IsSubsetOf : System.Security.IPermission -> bool
Public MustOverride Function IsSubsetOf (target As IPermission) As Boolean

Parâmetros

target
IPermission

Uma permissão que deve ser testada para a relação do subconjunto. Esta permissão deve ser do mesmo tipo da permissão atual.

Devoluções

Boolean

true se a permissão atual for um subconjunto da permissão especificada; caso contrário, false.

Implementações

IsSubsetOf(IPermission)

Exceções

ArgumentException

O target parâmetro não null é nem é do mesmo tipo que a permissão atual.

Observações

A permissão atual é um subconjunto da permissão especificada se a permissão atual especificar um conjunto de operações totalmente contido pela permissão especificada. Por exemplo, uma permissão que representa o acesso a C:\example.txt é um subconjunto de uma permissão que representa o acesso a C:\. Se este método devolver true, a permissão atual não representa mais acesso ao recurso protegido do que a permissão especificada.

As seguintes instruções são obrigatórias true para todos os overrides do IsSubsetOf método. X, Y e Z representam objetos personalizados de permissões de acesso ao código que não são referências nulas, U representa uma permissão de acesso ao código irrestrita, e N representa uma permissão vazia com um PermissionState de None.

  • X. IsSubsetOf(X) devolve true.
  • X. IsSubsetOf(Y) devolve o mesmo valor que Y. IsSubsetOf(X) se e só se X e Y representarem o mesmo conjunto de permissões.
  • Se X. IsSubsetOf(Y) e Y. IsSubsetOf(Z) ambos retornam true, X. IsSubsetOf(Z) devolve true.
  • X. IsSubsetOf(U) devolve true.
  • X. IsSubsetOf(N) devolve false.
  • N. IsSubsetOf(X) devolve true.

Se X e Y representam objetos de permissão de acesso a código personalizados que são referências nulas, X. IsSubsetOf(Y) devolve true. Se Z também for nulo, a operação de conjunto composto X. Sindicato(Y). IsSubsetOf(Z) também retorna true porque a união de duas permissões nulas é uma permissão nula.

Notas para Implementadores

Deve sobrescrever este método numa classe derivada.

Aplica-se a