Principal Klasse

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Quelle:

Principal.cs

Kapselt die gemeinsamen Kontodaten und Vorgänge für alle Sicherheitsprinzipale. Von dieser abstrakten Basisklasse werden alle Sicherheitsprinzipale abgeleitet.

public ref class Principal abstract : IDisposable

public abstract class Principal : IDisposable

type Principal = class
    interface IDisposable

Public MustInherit Class Principal
Implements IDisposable

Vererbung

Object

Principal

Abgeleitet

System.DirectoryServices.AccountManagement.AuthenticablePrincipal

System.DirectoryServices.AccountManagement.GroupPrincipal

Implementiert

IDisposable

Hinweise

Benutzerdefinierte Erweiterungsklassen, die von dieser Klasse abgeleitet werden, können diesen Konstruktor vom abgeleiteten Klassenkonstruktor aufrufen, um die Basisklasse zu initialisieren. Weitere Informationen finden Sie unter Übersicht über Prinzipalerweiterungen .

Konstruktoren

Principal()

Initialisiert eine neue Instanz der Principal-Klasse. Dieser Konstruktor wird von Konstruktoren für abgeleitete Klassen aufgerufen, um die Basisklasse zu initialisieren. Ein unmittelbares Aufrufen aus dem Code ist nicht vorgesehen.

Eigenschaften

Context	Ruft einen Prinzipalkontext ab, der mit dem Prinzipal verknüpft ist.
ContextRaw	Ruft einen Prinzipalkontext ab, der mit diesem Prinzipal verknüpft ist.
ContextType	Ruft den Enumerationswert für den Kontexttyp ab, der den Kontexttyp des Prinzipals angibt, der mit diesem Prinzipal verknüpft ist.
Description	Ruft die Beschreibung des Prinzipals ab oder legt diese fest.
DisplayName	Ruft den Anzeigenamen für den Prinzipal ab oder legt diesen fest.
DistinguishedName	Ruft den Distinguished Name (DN) für diesen Prinzipal ab.
Guid	Ruft die GUID ab, die mit diesem Prinzipal verknüpft ist.
Name	Ruft den Namen des Prinzipals ab oder legt diesen fest.
SamAccountName	Ruft den SAM-Kontonamen für den Prinzipal ab oder legt diesen fest.
Sid	Ruft die Sicherheits-ID (SID) des Prinzipals ab.
StructuralObjectClass	Ruft das Verzeichnisattribut der strukturellen Objektklasse ab.
UserPrincipalName	Ruft den diesem Prinzipal zugeordneten Benutzerprinzipalnamen (User Principal Name, UPN) ab, oder legt diesen fest.

Methoden

CheckDisposedOrDeleted()	Bestimmt, ob die Dispose()-Methode oder Delete()-Methode für diese Klasse aufgerufen wurde. Diese Methode wird von Klassen aufgerufen, die von der Prinzipalklasse abgeleitet werden.
Delete()	Löscht das Prinzipalobjekt aus dem Speicher.
Dispose()	Verwirft die aktuelle Instanz des Principal-Objekts.
Equals(Object)	Gibt einen booleschen Wert zurück, der angibt, ob das bereitgestellte Objekt gleich dem aktuellen Objekt ist.
ExtensionGet(String)	Ruft ein Attribut eines erweiterten Klassenobjekts ab.
ExtensionSet(String, Object)	Legt den Wert eines Attributs in einer erweiterten Klasse fest.
FindByIdentity(PrincipalContext, IdentityType, String)	Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity(PrincipalContext, IdentityType, String)-Methode bestimmt das Format des Identitätswerts.
FindByIdentity(PrincipalContext, String)	Gibt ein Prinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.
FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)	Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. 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.
FindByIdentityWithType(PrincipalContext, Type, String)	Gibt ein Prinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. 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.
GetGroups()	Gibt eine Auflistung von Gruppenobjekten zurück, die die Gruppen angeben, deren Member der aktuelle Prinzipal ist.
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.
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.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetUnderlyingObject()	Gibt das zugrunde liegende DirectoryEntry-Objekt zurück, das die Kontaktdaten für das Prinzipalobjekt bereitstellt.
GetUnderlyingObjectType()	Gibt den zugrunde liegenden Objekttyp zurück.
IsMemberOf(GroupPrincipal)	Gibt einen booleschen Wert zurück, der angibt, ob der Prinzipal ein Member der angegebenen Gruppe ist.
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.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Save()	Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den Speicher ein.
Save(PrincipalContext)	Speichert die Änderungen, die am Prinzipalobjekt des Speichers vorgenommen wurden. Wenn es sich dabei um ein neues Prinzipalobjekt handelt, fügt diese Methode es in den angegebenen Kontext ein. Wenn der Prinzipal bereits beibehalten wurde, wird er aus dem ursprünglichen Kontext in den angegebenen Kontext verschoben.
ToString()	Gibt eine benutzerfreundliche Zeichenfolgendarstellung des aktuellen Prinzipalobjekts zurück.