WindowsPrincipal Classe

Référence

Définition

Espace de noms:: System.Security.Principal

Assembly:: System.Security.Principal.Windows.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Permet au code de vérifier l'appartenance à un groupe Windows d'un utilisateur Windows.

public ref class WindowsPrincipal : System::Security::Claims::ClaimsPrincipal

public ref class WindowsPrincipal : System::Security::Principal::IPrincipal

public class WindowsPrincipal : System.Security.Claims.ClaimsPrincipal

[System.Serializable]
public class WindowsPrincipal : System.Security.Principal.IPrincipal

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class WindowsPrincipal : System.Security.Principal.IPrincipal

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class WindowsPrincipal : System.Security.Claims.ClaimsPrincipal

type WindowsPrincipal = class
    inherit ClaimsPrincipal

[<System.Serializable>]
type WindowsPrincipal = class
    interface IPrincipal

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type WindowsPrincipal = class
    interface IPrincipal

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type WindowsPrincipal = class
    inherit ClaimsPrincipal

Public Class WindowsPrincipal
Inherits ClaimsPrincipal

Public Class WindowsPrincipal
Implements IPrincipal

Héritage: Object

ClaimsPrincipal
WindowsPrincipal

Héritage: Object
WindowsPrincipal

Attributs: SerializableAttribute ComVisibleAttribute

Implémente: IPrincipal

Exemples

L’exemple suivant montre comment utiliser les surcharges de IsInRole méthode. L’énumération WindowsBuiltInRole est utilisée comme source pour les identificateurs relatifs (RID) qui identifient les rôles intégrés. Les RID sont utilisés pour déterminer les rôles du principal actuel.

public:
   static void DemonstrateWindowsBuiltInRoleEnum()
   {
      AppDomain^ myDomain = Thread::GetDomain();

      myDomain->SetPrincipalPolicy( PrincipalPolicy::WindowsPrincipal );
      WindowsPrincipal^ myPrincipal = dynamic_cast<WindowsPrincipal^>(Thread::CurrentPrincipal);

      Console::WriteLine( "{0} belongs to: ", myPrincipal->Identity->Name );

      Array^ wbirFields = Enum::GetValues( WindowsBuiltInRole::typeid );

      for each ( Object^ roleName in wbirFields )
      {
         try
         {
            Console::WriteLine( "{0}? {1}.", roleName,
               myPrincipal->IsInRole(  *dynamic_cast<WindowsBuiltInRole^>(roleName) ) );
         }
         catch ( Exception^ ) 
         {
            Console::WriteLine( "{0}: Could not obtain role for this RID.",
               roleName );
         }
      }
   }

using System;
using System.Threading;
using System.Security.Permissions;
using System.Security.Principal;

class SecurityPrincipalDemo
{
    public static void DemonstrateWindowsBuiltInRoleEnum()
    {
        AppDomain myDomain = Thread.GetDomain();

        myDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
        WindowsPrincipal myPrincipal = (WindowsPrincipal)Thread.CurrentPrincipal;
        Console.WriteLine("{0} belongs to: ", myPrincipal.Identity.Name.ToString());
        Array wbirFields = Enum.GetValues(typeof(WindowsBuiltInRole));
        foreach (object roleName in wbirFields)
        {
            try
            {
                // Cast the role name to a RID represented by the WindowsBuildInRole value.
                Console.WriteLine("{0}? {1}.", roleName,
                    myPrincipal.IsInRole((WindowsBuiltInRole)roleName));
                Console.WriteLine("The RID for this role is: " + ((int)roleName).ToString());
            }
            catch (Exception)
            {
                Console.WriteLine("{0}: Could not obtain role for this RID.",
                    roleName);
            }
        }
        // Get the role using the string value of the role.
        Console.WriteLine("{0}? {1}.", "Administrators",
            myPrincipal.IsInRole("BUILTIN\\" + "Administrators"));
        Console.WriteLine("{0}? {1}.", "Users",
            myPrincipal.IsInRole("BUILTIN\\" + "Users"));
        // Get the role using the WindowsBuiltInRole enumeration value.
        Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator,
           myPrincipal.IsInRole(WindowsBuiltInRole.Administrator));
        // Get the role using the WellKnownSidType.
        SecurityIdentifier sid = new SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, null);
        Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid));
    }

    public static void Main()
    {
        DemonstrateWindowsBuiltInRoleEnum();
    }
}

Imports System.Threading
Imports System.Security.Permissions
Imports System.Security.Principal

Class SecurityPrincipalDemo

    Public Shared Sub DemonstrateWindowsBuiltInRoleEnum()
        Dim myDomain As AppDomain = Thread.GetDomain()

        myDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal)
        Dim myPrincipal As WindowsPrincipal = CType(Thread.CurrentPrincipal, WindowsPrincipal)
        Console.WriteLine("{0} belongs to: ", myPrincipal.Identity.Name.ToString())
        Dim wbirFields As Array = [Enum].GetValues(GetType(WindowsBuiltInRole))
        Dim roleName As Object
        For Each roleName In wbirFields
            Try
                ' Cast the role name to a RID represented by the WindowsBuildInRole value.
                Console.WriteLine("{0}? {1}.", roleName, myPrincipal.IsInRole(CType(roleName, WindowsBuiltInRole)))
                Console.WriteLine("The RID for this role is: " + Fix(roleName).ToString())

            Catch
                Console.WriteLine("{0}: Could not obtain role for this RID.", roleName)
            End Try
        Next roleName
        ' Get the role using the string value of the role.
        Console.WriteLine("{0}? {1}.", "Administrators", myPrincipal.IsInRole("BUILTIN\" + "Administrators"))
        Console.WriteLine("{0}? {1}.", "Users", myPrincipal.IsInRole("BUILTIN\" + "Users"))
        ' Get the role using the WindowsBuiltInRole enumeration value.
        Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator, myPrincipal.IsInRole(WindowsBuiltInRole.Administrator))
        ' Get the role using the WellKnownSidType.
        Dim sid As New SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, Nothing)
        Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid))

    End Sub

    Public Shared Sub Main()
        DemonstrateWindowsBuiltInRoleEnum()

    End Sub
End Class

Remarques

La WindowsPrincipal classe est principalement utilisée pour vérifier le rôle d’un utilisateur Windows. Les WindowsPrincipal.IsInRole surcharges de méthode vous permettent de vérifier le rôle d’utilisateur à l’aide de différents contextes de rôle.

Constructeurs

WindowsPrincipal(WindowsIdentity)

Initialise une nouvelle instance de la classe WindowsPrincipal à l'aide de l'objet WindowsIdentity spécifié.

Propriétés

Claims	Obtient une collection qui contient toutes les revendications de toutes les identités basées sur les revendications associées à ce principal de revendications. (Hérité de ClaimsPrincipal)
CustomSerializationData	Contient les données supplémentaires fournies par un type dérivé. En règle générale, définie au moment de l’appel de WriteTo(BinaryWriter, Byte[]). (Hérité de ClaimsPrincipal)
DeviceClaims	Obtient toutes les revendications de périphérique Windows à partir de cette entité.
Identities	Obtient une collection qui contient toutes les identités de revendications associées à ce serveur de revendications principal. (Hérité de ClaimsPrincipal)
Identity	Obtient l'identité de l'objet Principal actuel.
UserClaims	Obtient toutes les revendications d'utilisateur Windows à partir de cette entité.

Méthodes

AddIdentities(IEnumerable<ClaimsIdentity>)	Ajoute au serveur de revendications principal les identités basées sur les revendications spécifiées. (Hérité de ClaimsPrincipal)
AddIdentity(ClaimsIdentity)	Ajoute l’identité basée sur les revendications spécifiée à ce principal de revendications. (Hérité de ClaimsPrincipal)
Clone()	Retourne une copie de cette instance. (Hérité de ClaimsPrincipal)
CreateClaimsIdentity(BinaryReader)	Crée une nouvelle identité basée sur les revendications. (Hérité de ClaimsPrincipal)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindAll(Predicate<Claim>)	Récupère toutes les revendications qui sont mises en correspondance par le prédicat spécifié. (Hérité de ClaimsPrincipal)
FindAll(String)	Récupère toutes les revendications qui ont le type de revendication spécifié. (Hérité de ClaimsPrincipal)
FindFirst(Predicate<Claim>)	Extrait la première revendication qui est mise en correspondance par le prédicat spécifié. (Hérité de ClaimsPrincipal)
FindFirst(String)	Extrait la première revendication avec le type de revendication spécifié. (Hérité de ClaimsPrincipal)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Renseigne des SerializationInfo avec les données nécessaires à la sérialisation de l'objet ClaimsPrincipal actuel. (Hérité de ClaimsPrincipal)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
HasClaim(Predicate<Claim>)	Détermine si l’une des identités de revendications associées à ce serveur de revendications principal contient une revendication qui correspond au prédicat spécifié. (Hérité de ClaimsPrincipal)
HasClaim(String, String)	Détermine si l’une des identités de revendications associées à ce serveur de revendications principal contient une revendication qui correspond au type et à la valeur spécifiés. (Hérité de ClaimsPrincipal)
IsInRole(Int32)	Détermine si l'objet Principal actuel appartient au groupe d'utilisateurs Windows avec l'identificateur relatif (RID, Relative Identifier) spécifié.
IsInRole(SecurityIdentifier)	Détermine si l'objet Principal actuel appartient au groupe d'utilisateurs Windows avec l'identificateur de sécurité (SID) spécifié.
IsInRole(String)	Détermine si l'objet Principal actuel appartient au groupe d'utilisateurs Windows avec le nom spécifié.
IsInRole(WindowsBuiltInRole)	Détermine si l'objet Principal actuel appartient au groupe d'utilisateurs Windows avec le WindowsBuiltInRole spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
WriteTo(BinaryWriter)	Sérialise à l’aide d’un BinaryWriter. (Hérité de ClaimsPrincipal)
WriteTo(BinaryWriter, Byte[])	Sérialise à l’aide d’un BinaryWriter. (Hérité de ClaimsPrincipal)

S’applique à