PermissionSet.IsSubsetOf(PermissionSet) Method

Reference

Definition

Namespace:: System.Security

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: System.Security.Permissions.dll

Package:: System.Security.Permissions v10.0.0-preview.1.25080.5

Source:: PermissionSet.cs

Source:: PermissionSet.cs

Source:: PermissionSet.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 bool IsSubsetOf(System::Security::PermissionSet ^ target);

public:
 virtual bool IsSubsetOf(System::Security::PermissionSet ^ target);

public bool IsSubsetOf(System.Security.PermissionSet? target);

public virtual bool IsSubsetOf(System.Security.PermissionSet target);

public bool IsSubsetOf(System.Security.PermissionSet target);

member this.IsSubsetOf : System.Security.PermissionSet -> bool

abstract member IsSubsetOf : System.Security.PermissionSet -> bool
override this.IsSubsetOf : System.Security.PermissionSet -> bool

Public Function IsSubsetOf (target As PermissionSet) As Boolean

Public Overridable Function IsSubsetOf (target As PermissionSet) As Boolean

Parameters

target: PermissionSet

The permission set to test for the subset relationship. This must be either a PermissionSet or a NamedPermissionSet.

Returns

Boolean

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

Examples

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.

// Create a second permission set and compare it to the first permission set.
ps2->AddPermission( gcnew EnvironmentPermission( EnvironmentPermissionAccess::Read,"USERNAME" ) );
ps2->AddPermission( gcnew 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 = {0}", 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.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"))
Console.WriteLine("Permissions in first permission set:")
Dim list As IEnumerator = ps1.GetEnumerator()
While list.MoveNext()
    Console.WriteLine(list.Current.ToString())
End While
Console.WriteLine("Second permission IsSubsetOf first permission = " & ps2.IsSubsetOf(ps1))

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.

Applies to

Product	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Share via