This topic has not yet been rated - Rate this topic

PermissionSet.IsSubsetOf Method

.NET Framework 2.0

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

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

public bool IsSubsetOf (
	PermissionSet target
)

public boolean IsSubsetOf (
	PermissionSet target
)

JScript

public function IsSubsetOf (
	target : PermissionSet
) : boolean

Parameters

target: A PermissionSet to test for the subset relationship. This must be either a PermissionSet or a NamedPermissionSet.

Return Value

true if the current PermissionSet is a subset of the target parameter; otherwise, false.

Remarks

A PermissionSet is a subset of the target PermissionSet if all demands that succeed for the PermissionSet also succeed for the target. That is, the target contains at least the permissions contained in the subset.

Example

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

C++

// Create a second permission set and compare it to the first permission set.
ps2.AddPermission(
    new EnvironmentPermission(EnvironmentPermissionAccess.Read, "USERNAME"));
ps2.AddPermission(
    new EnvironmentPermission(EnvironmentPermissionAccess.Write, "COMPUTERNAME"));
IEnumerator list =  ps1.GetEnumerator();
Console.WriteLine("Permissions in first permission set:");
while (list.MoveNext())
    Console.WriteLine(list.Current.ToString());
Console.WriteLine("Second permission IsSubsetOf first permission = " + ps2.IsSubsetOf(ps1));

// Create a second permission set and compare it to the
// first permission set.
ps2.AddPermission(new EnvironmentPermission(
    EnvironmentPermissionAccess.Read, "USERNAME"));
ps2.AddPermission(new EnvironmentPermission(
    EnvironmentPermissionAccess.Write, "COMPUTERNAME"));
IEnumerator list = ps1.GetEnumerator();
Console.WriteLine("Permissions in first permission set:");
while (list.MoveNext())
    Console.WriteLine(list.get_Current().ToString());
Console.WriteLine(
    ("Second permission IsSubsetOf first permission = "
    + System.Convert.ToString(ps2.IsSubsetOf(ps1))));

Platforms

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

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

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

Reference

PermissionSet Class
PermissionSet Members
System.Security Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD