Principal Classe

Définition

Encapsule les données et opérations de comptes communes à tous les principaux de sécurité.Encapsulates the account data and operations common to all security principals. Il s'agit de la classe de base abstraite de laquelle tous les principaux de sécurité sont dérivés.This is the abstract base class from which all security principals are derived.

public ref class Principal abstract : IDisposable
public abstract class Principal : IDisposable
type Principal = class
    interface IDisposable
Public MustInherit Class Principal
Implements IDisposable
Héritage
Principal
Dérivé
Implémente

Remarques

Les classes d’extension personnalisées qui dérivent de cette classe peuvent appeler ce constructeur à partir du constructeur de classe dérivée pour initialiser la classe de base.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Pour plus d’informations, consultez la rubrique vue d’ensemble des Extensions principales .For more information, see the Principal Extensions overview topic.

Constructeurs

Principal()

Initialise une nouvelle instance de la classe Principal.Initializes a new instance of the Principal class. Ce constructeur est appelé par des constructeurs de classe dérivée pour initialiser la classe de base et n'est pas destiné à être appelé directement depuis votre code.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

Propriétés

Context

Obtient un contexte d'entité de sécurité qui est associé à l'entité de sécurité.Gets a principal context that is associated with the principal.

ContextRaw

Obtient un contexte d'entité de sécurité associé cette entité de sécurité.Gets a principal context that is associated with this principal.

ContextType

Obtient la valeur d’énumération du type de contexte qui spécifie le type de contexte de principal associé à cette entité.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description

Obtient ou définit la description de l'entité de sécurité.Gets or sets the description of the principal.

DisplayName

Obtient ou définit le nom complet de cette entité de sécurité.Gets or sets the display name for this principal.

DistinguishedName

Obtient le nom unique (DN, Distinguished Name) de cette entité de sécurité.Gets the distinguished name (DN) for this principal.

Guid

Obtient le GUID associé à cette entité de sécurité.Gets the GUID associated with this principal.

Name

Obtient ou définit le nom de cette entité de sécurité.Gets or sets the name of this principal.

SamAccountName

Obtient ou définit le nom du compte SAM de cette entité de sécurité.Gets or sets the SAM account name for this principal.

Sid

Obtient l'ID de sécurité (SID) de l'entité de sécurité.Gets the Security ID (SID) of the principal.

StructuralObjectClass

Obtient l'attribut d'annuaire de la classe d'objets structurelle.Gets the structural object class directory attribute.

UserPrincipalName

Obtient ou définit le nom d’utilisateur principal (UPN) associé à ce principal.Gets or sets the user principal name (UPN) associated with this principal.

Méthodes

CheckDisposedOrDeleted()

Détermine si les méthodes Dispose() ou Delete() ont été appelées sur cette classe.Determines whether the Dispose() or Delete() methods have been called on this class. Cette méthode est appelée par les classes qui dérivent de cette classe Principal (entité de sécurité).This method is called by classes that derive from this principal class.

Delete()

Supprime l'objet Principal du magasin.Deletes the principal object from the store.

Dispose()

Élimine l'instance actuelle de l'objet Principal.Disposes the current instance of the Principal object.

Equals(Object)

Retourne une valeur booléenne qui indique si l'objet fourni est égal à l'objet actuel.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String)

Récupère un attribut d’un objet de classe étendue.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object)

Définit la valeur d'un attribut dans une classe étendue.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String)

Retourne un objet principal qui correspond au type et à la valeur d’identité spécifiés.Returns a principal object that matches the specified identity type, and value. Cette version de la méthode FindByIdentity(PrincipalContext, IdentityType, String) détermine le format de la valeur d’identité.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Retourne un objet Principal qui correspond à la valeur d'identité spécifiée.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

Retourne un objet principal qui correspond au type et à la valeur d’identité spécifiés.Returns a principal object that matches the specified identity type, and value. Cette méthode est appelée par l’implémentation de la méthode FindByIdentity de la classe dérivée pour restreindre la recherche au type de classe dérivée et n’est pas destinée à être appelée directement à partir de votre code.This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

FindByIdentityWithType(PrincipalContext, Type, String)

Retourne un objet principal qui correspond au type et à la valeur d’identité spécifiés.Returns a principal object that matches the specified identity type, and value. Cette méthode est appelée par l’implémentation de la méthode FindByIdentity de la classe dérivée pour restreindre la recherche au type de classe dérivée et n’est pas destinée à être appelée directement à partir de votre code.This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

GetGroups()

Retourne une collection d'objets de groupe qui spécifient les groupes desquels l'entité de sécurité actuelle est membre.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext)

Retourne une collection d'objets de groupe desquels l'entité de sécurité est membre et qui existent dans le magasin fourni par le paramètre de contexte spécifié.Returns a collection of group objects that the principal is a member of and that exist in the store provided by the specified context parameter.

GetHashCode()

Récupère le groupe de hachage créé à partir du contenu de l'objet Principal, approprié pour une utilisation dans les algorithmes de hachage et des structures de données telles qu'une table de hachage.Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUnderlyingObject()

Retourne l’objet DirectoryEntry sous-jacent qui fournit les données de contact de l’objet principal.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType()

Retourne le type d'objet sous-jacent.Returns the underlying object type.

IsMemberOf(GroupPrincipal)

Retourne une valeur de type Boolean qui spécifie si l'entité de sécurité est membre du groupe spécifié.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String)

Retourne une valeur de type Boolean qui spécifie si l'entité de sécurité est membre du groupe spécifié par le type et la valeur d'identité.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Save()

Enregistre les modifications apportées à l'objet Principal dans le magasin.Saves the changes that were made on the principal object to the store. S'il s'agit d'un nouvel objet Principal, cette méthode l'insère dans le magasin.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext)

Enregistre les modifications apportées à l'objet Principal dans le magasin.Saves the changes that were made on the principal object to the store. S'il s'agit d'un nouvel objet Principal, cette méthode l'insère dans le contexte spécifié.If this is a new principal object, this method inserts it into the specified context. Si l'entité de sécurité a déjà été rendue persistante, elle est déplacée du contexte d'origine au contexte spécifié.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString()

Retourne une représentation sous la forme d'une chaîne conviviale de l'objet Principal actuel.Returns a user friendly string representation of the current principal object.

S’applique à