GenericPrincipal(IIdentity, String[]) Constructor

Definition

Namespace:

System.Security.Principal

Assemblies:

netstandard.dll, System.Security.Claims.dll

Source:

GenericPrincipal.cs

Initializes a new instance of the GenericPrincipal class from a user identity and an array of role names to which the user represented by that identity belongs.

C#

public GenericPrincipal(System.Security.Principal.IIdentity identity, string[]? roles);

Parameters

identity

IIdentity

A basic implementation of IIdentity that represents any user.

roles

String[]

An array of role names to which the user represented by the identity parameter belongs.

Exceptions

ArgumentNullException

The identity parameter is null.

Examples

The following code shows the use of the GenericPrincipal constructor. This code example is part of a larger example provided for the GenericPrincipal class.

C#

WindowsIdentity windowsIdentity = WindowsIdentity.GetCurrent();
string[] roles = new string[10];
if (windowsIdentity.IsAuthenticated)
{
    // Add custom NetworkUser role.
    roles[0] = "NetworkUser";
}

if (windowsIdentity.IsGuest)
{
    // Add custom GuestUser role.
    roles[1] = "GuestUser";
}

if (windowsIdentity.IsSystem)
{
    // Add custom SystemUser role.
    roles[2] = "SystemUser";
}

// Construct a GenericIdentity object based on the current Windows
// identity name and authentication type.
string authenticationType = windowsIdentity.AuthenticationType;
string userName = windowsIdentity.Name;
GenericIdentity genericIdentity =
    new GenericIdentity(userName, authenticationType);

// Construct a GenericPrincipal object based on the generic identity
// and custom roles for the user.
GenericPrincipal genericPrincipal =
    new GenericPrincipal(genericIdentity, roles);

Applies to