Principal Principal Principal Principal Class

Definición

Encapsula los datos de la cuenta y las operaciones comunes a todas las entidades de seguridad.Encapsulates the account data and operations common to all security principals. Ésta es la clase base abstracta de la que se derivan todas las entidades de seguridad.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
Herencia
PrincipalPrincipalPrincipalPrincipal
Derivado
Implementaciones

Comentarios

Las clases de extensión personalizadas que derivan de esta clase pueden llamar a este constructor desde el constructor de la clase derivada para inicializar la clase base.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Para obtener más información, vea el tema información general sobre las extensiones principales .For more information, see the Principal Extensions overview topic.

Constructores

Principal() Principal() Principal() Principal()

Inicializa una nueva instancia de la clase Principal.Initializes a new instance of the Principal class. Para inicializar la clase base, los constructores de la clase derivada llaman a este constructor, que no se ha diseñado para que lo llame directamente el código.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

Propiedades

Context Context Context Context

Obtiene un contexto de entidad de seguridad asociado a la entidad de seguridad.Gets a principal context that is associated with the principal.

ContextRaw ContextRaw ContextRaw ContextRaw

Obtiene un contexto de entidad de seguridad asociado a esta entidad de seguridad.Gets a principal context that is associated with this principal.

ContextType ContextType ContextType ContextType

Obtiene el valor de la enumeración de tipo de contexto que especifica el tipo del contexto de la entidad de seguridad asociado a esta entidad de seguridad.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description Description Description Description

Obtiene o establece la descripción de una entidad de seguridad.Gets or sets the description of the principal.

DisplayName DisplayName DisplayName DisplayName

Obtiene o establece el nombre para mostrar de esta entidad de seguridad.Gets or sets the display name for this principal.

DistinguishedName DistinguishedName DistinguishedName DistinguishedName

Obtiene el nombre distintivo (DN) de esta entidad de seguridad.Gets the distinguished name (DN) for this principal.

Guid Guid Guid Guid

Obtiene el GUID asociado a esta entidad de seguridad.Gets the GUID associated with this principal.

Name Name Name Name

Obtiene o establece el nombre de la entidad de seguridad.Gets or sets the name of this principal.

SamAccountName SamAccountName SamAccountName SamAccountName

Obtiene o establece el nombre de cuenta SAM de esta entidad de seguridad.Gets or sets the SAM account name for this principal.

Sid Sid Sid Sid

Obtiene el identificador de seguridad (SID) de la entidad de seguridad.Gets the Security ID (SID) of the principal.

StructuralObjectClass StructuralObjectClass StructuralObjectClass StructuralObjectClass

Obtiene el atributo de directorio de clase de objeto estructural.Gets the structural object class directory attribute.

UserPrincipalName UserPrincipalName UserPrincipalName UserPrincipalName

Obtiene o establece el nombre principal de usuario (UPN) asociado a esta entidad de seguridad.Gets or sets the user principal name (UPN) associated with this principal.

Métodos

CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted() CheckDisposedOrDeleted()

Determina si se ha llamado a los métodos Dispose() o Delete() en esta clase.Determines whether the Dispose() or Delete() methods have been called on this class. Las clases que se derivan de esta clase de entidad de seguridad llaman a este método.This method is called by classes that derive from this principal class.

Delete() Delete() Delete() Delete()

Elimina el objeto de entidad de seguridad del almacén.Deletes the principal object from the store.

Dispose() Dispose() Dispose() Dispose()

Desecha la instancia actual del objeto Principal.Disposes the current instance of the Principal object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Devuelve un valor booleano que especifica si el objeto especificado es igual al objeto actual.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String) ExtensionGet(String) ExtensionGet(String) ExtensionGet(String)

Recupera un atributo de un objeto de la clase extendida.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object) ExtensionSet(String, Object)

Establece el valor de un atributo en una clase extendida.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String) FindByIdentity(PrincipalContext, IdentityType, String)

Devuelve un objeto principal que coincide con el tipo de identidad especificado y el valor.Returns a principal object that matches the specified identity type, and value. Esta versión del método FindByIdentity(PrincipalContext, IdentityType, String) determina el formato del valor de identidad.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String) FindByIdentity(PrincipalContext, String)

Devuelve un objeto de entidad de seguridad que coincide con el valor de identidad especificado.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

Devuelve un objeto principal que coincide con el tipo de identidad especificado y el valor.Returns a principal object that matches the specified identity type, and value. Para restringir la búsqueda al tipo de la clase derivada, la implementación del método FindByIdentity de la clase derivada llama a este método, que no se ha diseñado para que se llame desde el código.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) FindByIdentityWithType(PrincipalContext, Type, String) FindByIdentityWithType(PrincipalContext, Type, String) FindByIdentityWithType(PrincipalContext, Type, String)

Devuelve un objeto principal que coincide con el tipo de identidad especificado y el valor.Returns a principal object that matches the specified identity type, and value. Para restringir la búsqueda al tipo de la clase derivada, la implementación del método FindByIdentity de la clase derivada llama a este método, que no se ha diseñado para que se llame desde el código.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() GetGroups() GetGroups() GetGroups()

Devuelve una colección de objetos de grupo que especifican los grupos de los que es miembro la entidad de seguridad actual.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext) GetGroups(PrincipalContext) GetGroups(PrincipalContext) GetGroups(PrincipalContext)

Devuelve una colección de objetos de grupo de la que la entidad de seguridad es miembro y que existe en el almacén proporcionado por el parámetro de contexto especificado.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() GetHashCode() GetHashCode() GetHashCode()

Recupera el código hash creado a partir del contenido del objeto de entidad de seguridad, adecuado para su uso en algoritmos hash y estructuras de datos como una tabla hash.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() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject() GetUnderlyingObject()

Devuelve el objeto DirectoryEntry subyacente que proporciona los datos de contacto del objeto principal.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType() GetUnderlyingObjectType()

Devuelve el tipo de objeto subyacente.Returns the underlying object type.

IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal) IsMemberOf(GroupPrincipal)

Devuelve un valor booleano que especifica si la entidad de seguridad es miembro del grupo especificado.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String) IsMemberOf(PrincipalContext, IdentityType, String)

Devuelve un valor booleano que especifica si la entidad de seguridad es miembro del grupo especificado por el tipo y valor de identidad.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Save() Save() Save() Save()

Guarda en el almacén los cambios que se realizaron en el objeto de entidad de seguridad.Saves the changes that were made on the principal object to the store. Si éste es un nuevo objeto de entidad de seguridad, este método lo inserta en el almacén.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext) Save(PrincipalContext)

Guarda en el almacén los cambios que se realizaron en el objeto de entidad de seguridad.Saves the changes that were made on the principal object to the store. Si éste es un nuevo objeto de entidad de seguridad, este método lo inserta en el contexto especificado.If this is a new principal object, this method inserts it into the specified context. Si ya se ha conservado la entidad de seguridad, se mueve del contexto original al contexto especificado.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString() ToString() ToString() ToString()

Devuelve una representación de cadena fácil de usar del objeto de la entidad de seguridad actual.Returns a user friendly string representation of the current principal object.

Se aplica a