NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

CodeAccessPermission.IsSubsetOf

When implemented by a subclass, this method determines whether the current permission object is a subset of the specified permission.

[Visual Basic]
MustOverride Public Function IsSubsetOf( _
   ByVal target As IPermission _
) As Boolean
[C#]
public abstract bool IsSubsetOf(
   IPermission target
);
[C++]
public: virtual bool IsSubsetOf(
   IPermission* target
) = 0;
[JScript]
public abstract function IsSubsetOf(
   target : IPermission
) : Boolean;

Parameters

target
A permission object that is to be tested for the subset relationship. this object must be of the same type as the current permission object.

Return Value

True if the target permission is a subset of the permission object, or false otherwise.

Exceptions

Exception Type Condition
ArgumentException if target is an object that is not of the same type as the current permission object.

Remarks

The current permission object is a subset of the specified permission object if the current permission object specifies a set of operations that is wholly contained by the specified permission object. For example, a permission that represents access to "c:\foo.txt" is a subset of a permission that represents access to "c:\". If this method returns true, the current permission object represents no more access to the protected resource than target does.

Notes to Implementers: Each non-abstract subclass of the CodeAccessPermission class must implement IsSubsetOf, including the code access permissions supplied by the NGWS runtime. If you are implementing your own code access permission class, you must implement this method in the class you derive from CodeAccessPermission.

See Also

CodeAccessPermission Class | CodeAccessPermission Members | System.Security Namespace