IdentityPermissionSet Class

System.Net.Security

Introduction

The IdentityPermissionSet class represents a set of identity permissions. Identity permissions are used to control access to resources based on the identity of the code or user requesting access. This class provides methods for managing and comparing sets of identity permissions.

Syntax

public sealed class IdentityPermissionSet : PermissionSet, System.Collections.ICollection, System.Collections.IEnumerable

Members

Constructors

IdentityPermissionSet()

Initializes a new instance of the IdentityPermissionSet class with default settings.

IdentityPermissionSet(PermissionSet value)

Initializes a new instance of the IdentityPermissionSet class based on an existing PermissionSet.

Parameters

Methods

AddPermission

Adds a permission to the current permission set.

Parameters

Copy

Creates and returns an identical copy of the current permission set.

Equals

Determines whether the specified object is equal to the current permission set.

Parameters

Returns

true if the specified object is equal to the current permission set; otherwise, false.

GetHashCode

Returns the hash code for the current permission set.

Includes

Determines whether the current permission set includes all permissions in the specified permission set.

Parameters

Returns

true if the current permission set includes all permissions in the specified permission set; otherwise, false.

IsSubsetOf

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

Parameters

Returns

true if the current permission set is a subset of the specified permission set; otherwise, false.

Remarks

The IdentityPermissionSet class is used in conjunction with the Code Access Security (CAS) model in .NET Framework. It allows you to define and manage permissions related to the identity of code or users, which is crucial for enforcing security policies.

Example

using System;
using System.Net.Security;
using System.Security.Permissions;

public class Example
{
    public static void Main(string[] args)
    {
        // Create an IdentityPermissionSet
        IdentityPermissionSet idPermissionSet = new IdentityPermissionSet();

        // Create an identity permission (e.g., for a specific URL)
        // Note: IdentityPermission is abstract, use a concrete derived class if available or a general IdentityPermission
        // For demonstration, we'll use a hypothetical specific permission.
        // In a real scenario, you might use UrlIdentityPermission or Zone IdentityPermission if available.

        // Let's assume a hypothetical constructor for demonstration
        // In reality, you might need to deserialize or construct specific types.
        // For simplicity, we'll conceptualize adding a permission that grants access to "example.com"
        
        // Placeholder for a specific Identity Permission (e.g., UrlIdentityPermission)
        // The actual creation might involve deserialization or specific constructors.
        // IPermission specificPermission = new UrlIdentityPermission("http://www.example.com"); 
        
        // As a fallback for demonstration, let's simulate adding a conceptual permission.
        // This part is illustrative and might not compile directly without concrete IdentityPermission types.
        
        // Example of how you would typically add a permission if you had one:
        // idPermissionSet.AddPermission(specificPermission);

        Console.WriteLine("IdentityPermissionSet created.");
        // In a real scenario, you would check if permissions are granted based on this set.
    }
}

Requirements

See Also

• PermissionSet Class
• IPermission Interface
• System.Security.Permissions Namespace