Principal Principal Principal Principal Class

Definition

Kapselt die gemeinsamen Kontodaten und Vorgänge für alle Sicherheitsprinzipale.Encapsulates the account data and operations common to all security principals. Von dieser abstrakten Basisklasse werden alle Sicherheitsprinzipale abgeleitet.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
Vererbung
PrincipalPrincipalPrincipalPrincipal
Abgeleitet
Implementiert

Hinweise

Benutzerdefinierte Erweiterung-Klassen, die von dieser Klasse ableiten können Aufrufen dieses Konstruktors vom Konstruktor abgeleiteten Klasse die Basisklasse zu initialisieren.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Weitere Informationen finden Sie unter den Prinzipalerweiterungen Übersichtsthema.For more information, see the Principal Extensions overview topic.

Konstruktoren

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

Initialisiert eine neue Instanz der Principal-Klasse.Initializes a new instance of the Principal class. Dieser Konstruktor wird von Konstruktoren für abgeleitete Klassen aufgerufen, um die Basisklasse zu initialisieren. Ein unmittelbares Aufrufen aus dem Code ist nicht vorgesehen.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

Eigenschaften

Context Context Context Context

Ruft einen Prinzipalkontext ab, der mit dem Prinzipal verknüpft ist.Gets a principal context that is associated with the principal.

ContextRaw ContextRaw ContextRaw ContextRaw

Ruft einen Prinzipalkontext ab, der mit diesem Prinzipal verknüpft ist.Gets a principal context that is associated with this principal.

ContextType ContextType ContextType ContextType

Ruft den Enumerationswert für den Kontexttyp ab, der den Kontexttyp des Prinzipals angibt, der mit diesem Prinzipal verknüpft ist.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description Description Description Description

Ruft die Beschreibung des Prinzipals ab oder legt diese fest.Gets or sets the description of the principal.

DisplayName DisplayName DisplayName DisplayName

Ruft den Anzeigenamen für den Prinzipal ab oder legt diesen fest.Gets or sets the display name for this principal.

DistinguishedName DistinguishedName DistinguishedName DistinguishedName

Ruft den Distinguished Name (DN) für diesen Prinzipal ab.Gets the distinguished name (DN) for this principal.

Guid Guid Guid Guid

Ruft die GUID ab, die mit diesem Prinzipal verknüpft ist.Gets the GUID associated with this principal.

Name Name Name Name

Ruft den Namen des Prinzipals ab oder legt diesen fest.Gets or sets the name of this principal.

SamAccountName SamAccountName SamAccountName SamAccountName

Ruft den SAM-Kontonamen für den Prinzipal ab oder legt diesen fest.Gets or sets the SAM account name for this principal.

Sid Sid Sid Sid

Ruft die Sicherheits-ID (SID) des Prinzipals ab.Gets the Security ID (SID) of the principal.

StructuralObjectClass StructuralObjectClass StructuralObjectClass StructuralObjectClass

Ruft das Verzeichnisattribut der strukturellen Objektklasse ab.Gets the structural object class directory attribute.

UserPrincipalName UserPrincipalName UserPrincipalName UserPrincipalName

Ruft den diesem Prinzipal zugeordneten Benutzerprinzipalnamen (User Principal Name, UPN) ab, oder legt diesen fest.Gets or sets the user principal name (UPN) associated with this principal.

Methoden

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

Bestimmt, ob die Dispose()-Methode oder Delete()-Methode für diese Klasse aufgerufen wurde.Determines whether the Dispose() or Delete() methods have been called on this class. Diese Methode wird von Klassen aufgerufen, die von der Prinzipalklasse abgeleitet werden.This method is called by classes that derive from this principal class.

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

Löscht das Prinzipalobjekt aus dem Speicher.Deletes the principal object from the store.

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

Verwirft die aktuelle Instanz des Principal-Objekts.Disposes the current instance of the Principal object.

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

Gibt einen booleschen Wert zurück, der angibt, ob das bereitgestellte Objekt gleich dem aktuellen Objekt ist.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

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

Ruft ein Attribut eines erweiterten Klassenobjekts ab.Retrieves an attribute of an extended class object.

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

Legt den Wert eines Attributs in einer erweiterten Klasse fest.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)

Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht.Returns a principal object that matches the specified identity type, and value. Diese Version der FindByIdentity(PrincipalContext, IdentityType, String)-Methode bestimmt das Format des Identitätswerts.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)

Gibt ein Prinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.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)

Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht.Returns a principal object that matches the specified identity type, and value. Diese Methode wird von der Implementierung der FindByIdentity-Methode für abgeleitete Klassen aufgerufen, um die Suche auf den abgeleiteten Klassentyp einzuschränken. Ein direktes Aufrufen aus dem Code ist nicht vorgesehen.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)

Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht.Returns a principal object that matches the specified identity type, and value. Diese Methode wird von der Implementierung der FindByIdentity-Methode für abgeleitete Klassen aufgerufen, um die Suche auf den abgeleiteten Klassentyp einzuschränken. Ein direktes Aufrufen aus dem Code ist nicht vorgesehen.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()

Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.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)

Gibt eine Auflistung von Gruppenobjekten zurück, deren Member der Prinzipal ist und die im Speicher vorhanden sind, der vom angegebenen Kontextparameter bereitgestellt wird.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()

Ruft den Hashcode für den Inhalt des Prinzipalobjekts ab, der für die Verwendung in Hashalgorithmen und Hashdatenstrukturen geeignet ist, z. B. in einer Hashtabelle.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()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Gibt das zugrunde liegende DirectoryEntry-Objekt zurück, das die Kontaktdaten für das Prinzipalobjekt bereitstellt.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

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

Gibt den zugrunde liegenden Objekttyp zurück.Returns the underlying object type.

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

Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der angegebenen Gruppe ist.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)

Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der Gruppe ist, die durch den Identitätstyp und den Identitätswert angegeben wird.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()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden.Saves the changes that were made on the principal object to the store. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den Speicher ein.If this is a new principal object, this method inserts it into the store.

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

Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden.Saves the changes that were made on the principal object to the store. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den angegebenen Kontext ein.If this is a new principal object, this method inserts it into the specified context. Wenn der Prinzipal bereits beibehalten wurde, wird er aus dem ursprünglichen Kontext in den angegebenen Kontext verschoben.If the principal has already been persisted, it is moved from the original context to the specified context.

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

Gibt eine benutzerfreundliche Zeichenfolgendarstellung des aktuellen Prinzipalobjekts zurück.Returns a user friendly string representation of the current principal object.

Gilt für: