WindowsClaimsPrincipal.IsInRole Method (SecurityIdentifier)

[Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5, see the Windows Identity Foundation documentation in the .NET Framework 4.5 Development Guide.]

Returns a value that indicates whether this principal is in the role of the specified security identifier (SID). The SID is specified as a SecurityIdentifier.

Namespace: Microsoft.IdentityModel.Claims
Assembly: Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)


Dim instance As WindowsClaimsPrincipal
Dim sid As SecurityIdentifier
Dim returnValue As Boolean

returnValue = instance.IsInRole(sid)


Public Overrides Function IsInRole ( _
    sid As SecurityIdentifier _
) As Boolean
public override bool IsInRole (
    SecurityIdentifier sid
virtual bool IsInRole (
    SecurityIdentifier^ sid
) override
public boolean IsInRole (
    SecurityIdentifier sid
public override function IsInRole (
    sid : SecurityIdentifier
) : boolean


  • sid
    A SecurityIdentifier that represents the SID that should be searched for on the contained identities.

Return Value

true if the role exists as a Windows group or as a value on a role claim type in one of the contained IClaimsIdentity objects; otherwise, false.


Exception type Condition


The method determines whether the principal contains a matching group security identifier or whether one of the principal’s contained identities possesses a matching claim value for the claim type that is specified by that identity’s RoleClaimType property. The identities associated with the principal can be accessed through the Identities property.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Target Platforms

Windows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)

See Also


WindowsClaimsPrincipal Class
WindowsClaimsPrincipal Members
Microsoft.IdentityModel.Claims Namespace

Copyright © 2008 by Microsoft Corporation. All rights reserved.