GenericIdentity Class
.NET Framework 4.5
Represents a generic user.
System.Object
System.Security.Claims.ClaimsIdentity
System.Security.Principal.GenericIdentity
System.Net.HttpListenerBasicIdentity
System.Security.Claims.ClaimsIdentity
System.Security.Principal.GenericIdentity
System.Net.HttpListenerBasicIdentity
Namespace: System.Security.Principal
Assembly: mscorlib (in mscorlib.dll)
The GenericIdentity type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | GenericIdentity(GenericIdentity) | Initializes a new instance of the GenericIdentity class by using the specified GenericIdentity object. |
![]() | GenericIdentity(String) | Initializes a new instance of the GenericIdentity class representing the user with the specified name. |
![]() | GenericIdentity(String, String) | Initializes a new instance of the GenericIdentity class representing the user with the specified name and authentication type. |
| Name | Description | |
|---|---|---|
![]() | Actor | Gets or sets the identity of the calling party that was granted delegation rights. (Inherited from ClaimsIdentity.) |
![]() | AuthenticationType | Gets the type of authentication used to identify the user. (Overrides ClaimsIdentity.AuthenticationType.) |
![]() | BootstrapContext | Gets or sets the token that was used to create this claims identity. (Inherited from ClaimsIdentity.) |
![]() | Claims | Gets all claims for the user represented by this generic identity. (Overrides ClaimsIdentity.Claims.) |
![]() | IsAuthenticated | Gets a value indicating whether the user has been authenticated. (Overrides ClaimsIdentity.IsAuthenticated.) |
![]() | Label | Gets or sets the label for this claims identity. (Inherited from ClaimsIdentity.) |
![]() | Name | Gets the user's name. (Overrides ClaimsIdentity.Name.) |
![]() | NameClaimType | Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity. (Inherited from ClaimsIdentity.) |
![]() | RoleClaimType | Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity. (Inherited from ClaimsIdentity.) |
| Name | Description | |
|---|---|---|
![]() | AddClaim | Adds a single claim to this claims identity. (Inherited from ClaimsIdentity.) |
![]() | AddClaims | Adds a list of claims to this claims identity. (Inherited from ClaimsIdentity.) |
![]() | Clone | Creates a new object that is a copy of the current instance. (Overrides ClaimsIdentity.Clone().) |
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | FindAll(Predicate<Claim>) | Retrieves all of the claims that are matched by the specified predicate. (Inherited from ClaimsIdentity.) |
![]() | FindAll(String) | Retrieves all of the claims that have the specified claim type. (Inherited from ClaimsIdentity.) |
![]() | FindFirst(Predicate<Claim>) | Retrieves the first claim that is matched by the specified predicate. (Inherited from ClaimsIdentity.) |
![]() | FindFirst(String) | Retrieves the first claim with the specified claim type. (Inherited from ClaimsIdentity.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetObjectData | Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object. (Inherited from ClaimsIdentity.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | HasClaim(Predicate<Claim>) | Determines whether this claims identity has a claim that is matched by the specified predicate. (Inherited from ClaimsIdentity.) |
![]() | HasClaim(String, String) | Determines whether this claims identity has a claim with the specified claim type and value. (Inherited from ClaimsIdentity.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | RemoveClaim | Attempts to remove a claim from the claims identity. (Inherited from ClaimsIdentity.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
![]() | TryRemoveClaim | Attempts to remove a claim from the claims identity. (Inherited from ClaimsIdentity.) |
An identity object represents the user on whose behalf the code is running.
| Topic | Location |
|---|---|
| How to: Create GenericPrincipal and GenericIdentity Objects | .NET Framework: Security |
| How to: Create GenericPrincipal and GenericIdentity Objects | .NET Framework: Security |
The following example shows the use of members of the GenericIdentity class.
using System; using System.Security.Principal; class GenericIdentityMembers { [STAThread] static void Main(string[] args) { // Create a GenericIdentity object with no authentication type // specified. GenericIdentity defaultIdentity = new GenericIdentity("DefaultUser"); // Retrieve a GenericIdentity created from current WindowsIdentity // values. GenericIdentity currentIdentity = GetGenericIdentity(); ShowIdentityPreferences(new GenericIdentity("")); ShowIdentityPreferences(defaultIdentity); ShowIdentityPreferences(currentIdentity); Console.WriteLine("The sample completed successfully; " + "press Enter to continue."); Console.ReadLine(); } // Print identity preferences to the console window. private static void ShowIdentityPreferences( GenericIdentity genericIdentity) { // Retrieve the name of the generic identity object. string identityName = genericIdentity.Name; // Retrieve the authentication type of the generic identity object. string identityAuthenticationType = genericIdentity.AuthenticationType; Console.WriteLine("Name: " + identityName); Console.WriteLine("Type: " + identityAuthenticationType); // Verify that the user's identity has been authenticated // (was created with a valid name). if (genericIdentity.IsAuthenticated) { Console.WriteLine("The user's identity has been authenticated."); } else { Console.WriteLine("The user's identity has not been " + "authenticated."); } Console.WriteLine("~~~~~~~~~~~~~~~~~~~~~~~~~"); } // Create generic identity based on values from the current // WindowsIdentity. private static GenericIdentity GetGenericIdentity() { // Get values from the current WindowsIdentity. WindowsIdentity windowsIdentity = WindowsIdentity.GetCurrent(); // Construct a GenericIdentity object based on the current Windows // identity name and authentication type. string authenticationType = windowsIdentity.AuthenticationType; string userName = windowsIdentity.Name; GenericIdentity authenticatedGenericIdentity = new GenericIdentity(userName, authenticationType); return authenticatedGenericIdentity; } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
