DataProtectionPermission::IsSubsetOf Method (IPermission^)

 

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

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

public:
virtual bool IsSubsetOf(
	IPermission^ target
) override

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? {0}", (rc ? (String^)"Yes" : "No") );
rc = sp1->IsSubsetOf( sp2 );
Console::WriteLine( "Is the permission with ProtectData access a "
"subset of the permission with \n"
"\tAllFlags set? {0}", (rc ? (String^)"Yes" : "No") );

.NET Framework
Available since 2.0
Return to top
Show: