Principal Classe

Definição

Encapsula os dados da conta e as operações comuns a todas as entidades de segurança.Encapsulates the account data and operations common to all security principals. Esta é a classe base abstrata da qual todas as entidades de segurança são derivadas.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
Herança
Principal
Derivado
Implementações

Comentários

Classes de extensão personalizadas que derivam dessa classe podem chamar esse construtor do construtor de classe derivada para inicializar a classe base.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Para obter mais informações, consulte o tópico Visão geral das extensões de entidade de segurança .For more information, see the Principal Extensions overview topic.

Construtores

Principal()

Inicia uma nova instância da classe Principal.Initializes a new instance of the Principal class. Este construtor é chamado por construtores de classe derivada para inicializar a classe base e não se destina a ser chamado diretamente do seu 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.

Propriedades

Context

Obtém um contexto de entidade que está associado à entidade.Gets a principal context that is associated with the principal.

ContextRaw

Obtém um contexto de entidade de segurança associado a essa entidade de segurança.Gets a principal context that is associated with this principal.

ContextType

Obtém o valor de enumeração do tipo de contexto que especifica o tipo de contexto de entidade de segurança associado a essa entidade de segurança.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description

Obtém ou define a descrição da entidade de segurança.Gets or sets the description of the principal.

DisplayName

Obtém ou define o nome de exibição dessa entidade de segurança.Gets or sets the display name for this principal.

DistinguishedName

Obtém o DN (nome diferenciado) dessa entidade de segurança.Gets the distinguished name (DN) for this principal.

Guid

Obtém o GUID associado a essa entidade de segurança.Gets the GUID associated with this principal.

Name

Obtém ou define o nome dessa entidade de segurança.Gets or sets the name of this principal.

SamAccountName

Obtém ou define o nome da conta SAM dessa entidade de segurança.Gets or sets the SAM account name for this principal.

Sid

Obtém a SID (identificador de segurança) da entidade de segurança.Gets the Security ID (SID) of the principal.

StructuralObjectClass

Obtém o atributo de diretório da classe do objeto estrutural.Gets the structural object class directory attribute.

UserPrincipalName

Obtém ou define o nome UPN associado a essa entidade.Gets or sets the user principal name (UPN) associated with this principal.

Métodos

CheckDisposedOrDeleted()

Determina se os métodos Dispose() ou Delete() foram chamados nessa classe.Determines whether the Dispose() or Delete() methods have been called on this class. Este método é chamado por classes que derivam dessa classe entidade de segurança.This method is called by classes that derive from this principal class.

Delete()

Exclui o objeto de entidade de segurança do repositório.Deletes the principal object from the store.

Dispose()

Descarta a instância atual do objeto Principal.Disposes the current instance of the Principal object.

Equals(Object)

Retorna um valor booliano que especifica se o objeto fornecido é igual ao objeto atual.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String)

Recupera um atributo de um objeto de classe estendido.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object)

Define o valor de um atributo em uma classe estendida.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String)

Retorna um objeto de entidade de segurança que corresponde ao tipo de identidade especificado e o valor.Returns a principal object that matches the specified identity type, and value. Essa versão do método FindByIdentity(PrincipalContext, IdentityType, String) determina o formato do valor de identidade.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Retorna um objeto de entidade de segurança que corresponde ao valor de identidade especificado.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

Retorna um objeto de entidade de segurança que corresponde ao tipo de identidade especificado e o valor.Returns a principal object that matches the specified identity type, and value. Este método é chamado pela implementação do método FindByIdentity de classe derivada para restringir a pesquisa para o tipo de classe derivada e não se destina a ser chamado diretamente no seu 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)

Retorna um objeto de entidade de segurança que corresponde ao tipo de identidade especificado e o valor.Returns a principal object that matches the specified identity type, and value. Este método é chamado pela implementação do método FindByIdentity de classe derivada para restringir a pesquisa para o tipo de classe derivada e não se destina a ser chamado diretamente no seu 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()

Retorna uma coleção de objetos de grupo que especificam os grupos dos quais a entidade atual é membro.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext)

Retorna uma coleção de objetos de grupo da qual a entidade de segurança é um membro e que existe no repositório fornecido pelo 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()

Recupera o hash criado usando o conteúdo do objeto da entidade de segurança, adequado para uso em algoritmos de hash e estruturas de dados como uma tabela de 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()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUnderlyingObject()

Retorna o objeto DirectoryEntry subjacente que fornece os dados de contato para o objeto de entidade de segurança.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType()

Retorna o tipo de objeto subjacente.Returns the underlying object type.

IsMemberOf(GroupPrincipal)

Retorna um valor booliano que especifica se a entidade de segurança é membro do grupo especificado.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String)

Retorna um valor booliano que especifica se a entidade de segurança é um membro do grupo especificado por valor e tipo de identidade.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Save()

Salva as alterações feitas no objeto da entidade de segurança no repositório.Saves the changes that were made on the principal object to the store. Se esse for um novo objeto de entidade de segurança, esse método o insere no repositório.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext)

Salva as alterações feitas no objeto da entidade de segurança no repositório.Saves the changes that were made on the principal object to the store. Se esse for um novo objeto de entidade de segurança, esse método o insere no contexto especificado.If this is a new principal object, this method inserts it into the specified context. Se a entidade de segurança já tiver sido persistida, ela será movida do contexto original para o contexto especificado.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString()

Retorna uma representação de cadeia de caracteres amigável do objeto da entidade de segurança atual.Returns a user friendly string representation of the current principal object.

Aplica-se a