CodeAccessPermission.IsSubsetOf(IPermission) Método

Definição

Namespace:
System.Security
Assembly:
mscorlib.dll

Quando implementada 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 de subconjunto. Essa permissão deve ser do mesmo tipo que a permissão atual.

Retornos

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 é e não é do mesmo tipo que a permissão atual.

Comentários

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 ao C:\example.txt é um subconjunto de uma permissão que representa o acesso a C:\. Se esse método retornar true, a permissão atual não representará mais acesso ao recurso protegido do que a permissão especificada.

As instruções a seguir são necessárias para true todas as substituições do IsSubsetOf método. X, Y e Z representam objetos de permissão de acesso de código personalizados que não são referências nulas, U representa uma permissão de acesso de código irrestrito e N representa uma permissão vazia com um PermissionState de None.

  • X. IsSubsetOf(X) retorna true.
  • X. IsSubsetOf(Y) retorna o mesmo valor que Y. IsSubsetOf(X) se e somente 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) retorna true.
  • X. IsSubsetOf(U) retorna true.
  • X. IsSubsetOf(N) retorna false.
  • N. IsSubsetOf(X) retorna true.

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

Notas aos Implementadores

Você deve substituir esse método em uma classe derivada.

Aplica-se a