Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

CodeAccessPermission.IsSubsetOf Method

When implemented by a derived class, determines whether the current permission is a subset of the specified permission.

Namespace:  System.Security
Assembly:  mscorlib (in mscorlib.dll)

public abstract bool IsSubsetOf(
	IPermission target


Type: System.Security.IPermission

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

Return Value

Type: System.Boolean
true if the current permission is a subset of the specified permission; otherwise, false.




The target parameter is not null and is not of the same type as the current permission.

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

The following statements are required to be true for all overrides of the IsSubsetOf method. X, Y, and Z represent custom code access permission objects that are not null references, U represents an unrestricted code access permission, and N represents an empty permission with a PermissionState of None.

  • X.IsSubsetOf(X) returns true.

  • X.IsSubsetOf(Y) returns the same value as Y.IsSubsetOf(X) if and only if X and Y represent the same set of permissions.

  • If X.IsSubsetOf(Y) and Y.IsSubsetOf(Z) both return true, X.IsSubsetOf(Z) returns true.

  • X.IsSubsetOf(U) returns true.

  • X.IsSubsetOf(N) returns false.

  • N.IsSubsetOf(X) returns true.

If X and Y represent custom code access permission objects that are null references, X.IsSubsetOf(Y) returns true. If Z is also null, the compound set operation X.Union(Y).IsSubsetOf(Z) also returns true because the union of two null permissions is a null permission.

Notes to Inheritors:

You must override this method in a derived class.

The following code example shows an override of the IsSubsetOf method. This code example is part of a larger example provided for the CodeAccessPermission class.

        public override bool IsSubsetOf(IPermission target)
            Console.WriteLine ("************* Entering IsSubsetOf *********************");
            if (target == null)
                Console.WriteLine ("IsSubsetOf: target == null");
                return false;

            Console.WriteLine ("This is = " + (( NameIdPermission)this).Name);
            Console.WriteLine ("Target is " + (( NameIdPermission)target).m_Name);
                 NameIdPermission operand = ( NameIdPermission)target;

                // The following check for unrestricted permission is only included as an example for 
                // permissions that allow the unrestricted state. It is of no value for this permission. 
                if (true == operand.m_Unrestricted)
                    return true;
                else if (true == this.m_Unrestricted)
                    return false;

                if (this.m_Name != null)
                    if (operand.m_Name == null) return false;

                    if (this.m_Name == "") return true;

                if (this.m_Name.Equals (operand.m_Name)) return true;
                    // Check for wild card character '*'. 
                    int i = operand.m_Name.LastIndexOf ("*");

                    if (i > 0)
                        string prefix = operand.m_Name.Substring (0, i);

                        if (this.m_Name.StartsWith (prefix))
                            return true;

                return false;
            catch (InvalidCastException)
                throw new ArgumentException (String.Format ("Argument_WrongType", this.GetType ().FullName));

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

© 2015 Microsoft