DataProtectionPermission.IsSubsetOf Method (IPermission)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Determines whether the current permission is a subset of the specified permission.

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

public override bool IsSubsetOf(
	IPermission target
)

Parameters

target
Type: System.Security.IPermission

A permission to test for the subset relationship. This permission must be 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.

Exception Condition
ArgumentException

target is not null and does not specify a permission 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 in the specified permission. For example, a permission for ProtectData access is a subset of a permission for AllFlags access.

The following code example shows the use of the IsSubsetOf method. This code example is part of a larger example provided for the DataProtectionPermission class.

System_CAPS_noteNote

The code example is intended to show the behavior of the method, not to demonstrate its use. In general, the methods of permission classes are used by the security infrastructure; they are not typically used in applications.

bool rc = sp2.IsSubsetOf(sp3);
Console.WriteLine("Is the permission with all flags set (AllFlags) " +
    "a subset of \n \tthe permission with an Unrestricted " +
    "permission state? " + (rc ? "Yes" : "No"));
rc = sp1.IsSubsetOf(sp2);
Console.WriteLine("Is the permission with ProtectData access a " +
    "subset of the permission with \n" + "\tAllFlags set? " +
    (rc ? "Yes" : "No"));

.NET Framework
Available since 2.0
Return to top
Show: