Principal Klasa

Definicja

Hermetyzuje dane konta i wspólne operacje dla wszystkich podmiotów zabezpieczeń.Encapsulates the account data and operations common to all security principals. Jest to abstrakcyjna klasa bazowa, z której są wyprowadzane wszystkie podmioty zabezpieczeń.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
Dziedziczenie
Principal
Pochodne
Implementuje

Uwagi

Klasy rozszerzeń niestandardowych, które pochodzą z tej klasy, mogą wywoływać tego konstruktora z konstruktora klasy pochodnej, aby zainicjować klasę bazową.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Aby uzyskać więcej informacji, zobacz temat Omówienie rozszerzeń głównych .For more information, see the Principal Extensions overview topic.

Konstruktory

Principal()

Inicjuje nowe wystąpienie klasy Principal klasy.Initializes a new instance of the Principal class. Ten konstruktor jest wywoływany przez konstruktory klas pochodnych w celu zainicjowania klasy bazowej i nie jest przeznaczony do wywoływania bezpośrednio w kodzie.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

Właściwości

Context

Pobiera kontekst podmiotu zabezpieczeń skojarzony z podmiotem zabezpieczeń.Gets a principal context that is associated with the principal.

ContextRaw

Pobiera kontekst podmiotu zabezpieczeń skojarzony z tym podmiotem zabezpieczeń.Gets a principal context that is associated with this principal.

ContextType

Pobiera wartość wyliczenia typu kontekstu, która określa typ kontekstu podmiotu skojarzonego z tym podmiotem zabezpieczeń.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description

Pobiera lub ustawia opis podmiotu zabezpieczeń.Gets or sets the description of the principal.

DisplayName

Pobiera lub ustawia nazwę wyświetlaną dla tego podmiotu zabezpieczeń.Gets or sets the display name for this principal.

DistinguishedName

Pobiera nazwę wyróżniającą (DN) dla tego podmiotu zabezpieczeń.Gets the distinguished name (DN) for this principal.

Guid

Pobiera identyfikator GUID skojarzony z tym podmiotem zabezpieczeń.Gets the GUID associated with this principal.

Name

Pobiera lub ustawia nazwę tego podmiotu zabezpieczeń.Gets or sets the name of this principal.

SamAccountName

Pobiera lub ustawia nazwę konta SAM dla tego podmiotu zabezpieczeń.Gets or sets the SAM account name for this principal.

Sid

Pobiera identyfikator zabezpieczeń (SID) obiektu głównego.Gets the Security ID (SID) of the principal.

StructuralObjectClass

Pobiera atrybut katalogu klasy obiektu strukturalnego.Gets the structural object class directory attribute.

UserPrincipalName

Pobiera lub ustawia główną nazwę użytkownika (UPN) skojarzoną z tym podmiotem zabezpieczeń.Gets or sets the user principal name (UPN) associated with this principal.

Metody

CheckDisposedOrDeleted()

Określa, Dispose() czy metody Delete() lub zostały wywołane dla tej klasy.Determines whether the Dispose() or Delete() methods have been called on this class. Ta metoda jest wywoływana przez klasy, które pochodzą z tej klasy głównej.This method is called by classes that derive from this principal class.

Delete()

Usuwa obiekt Principal ze sklepu.Deletes the principal object from the store.

Dispose()

Usuwa bieżące wystąpienie Principal obiektu.Disposes the current instance of the Principal object.

Equals(Object)

Zwraca wartość logiczną określającą, czy dostarczony obiekt jest równy bieżącemu obiektowi.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String)

Pobiera atrybut obiektu klasy rozszerzonej.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object)

Ustawia wartość atrybutu w klasie rozszerzonej.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String)

Zwraca obiekt Principal, który jest zgodny z określonym typem tożsamości i wartością.Returns a principal object that matches the specified identity type, and value. Ta wersja FindByIdentity(PrincipalContext, IdentityType, String) metody Określa format wartości tożsamości.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Zwraca obiekt Principal, który jest zgodny z określoną wartością tożsamości.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

Zwraca obiekt Principal, który jest zgodny z określonym typem tożsamości i wartością.Returns a principal object that matches the specified identity type, and value. Ta metoda jest wywoływana przez implementację metody FindByIdentity klasy pochodnej w celu ograniczenia wyszukiwania do typu klasy pochodnej i nie jest przeznaczona do wywoływania bezpośrednio w kodzie.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)

Zwraca obiekt Principal, który jest zgodny z określonym typem tożsamości i wartością.Returns a principal object that matches the specified identity type, and value. Ta metoda jest wywoływana przez implementację metody FindByIdentity klasy pochodnej w celu ograniczenia wyszukiwania do typu klasy pochodnej i nie jest przeznaczona do wywoływania bezpośrednio w kodzie.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()

Zwraca kolekcję obiektów grupy, które określają grupy, których bieżącym podmiotem jest element członkowski.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext)

Zwraca kolekcję obiektów grupy, do której należy podmiot zabezpieczeń i który istnieje w magazynie udostępnionym przez określony parametr kontekstowy.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()

Pobiera skrót utworzony z zawartości obiektu Principal, odpowiedni do użycia w algorytmach wyznaczania wartości skrótu i strukturach danych, takich jak tabela skrótów.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()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUnderlyingObject()

Zwraca obiekt źródłowy DirectoryEntry , który dostarcza dane osoby kontaktowej dla obiektu podmiotu zabezpieczeń.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType()

Zwraca typ obiektu źródłowego.Returns the underlying object type.

IsMemberOf(GroupPrincipal)

Zwraca wartość logiczną określającą, czy podmiot zabezpieczeń jest członkiem określonej grupy.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String)

Zwraca wartość logiczną określającą, czy podmiot zabezpieczeń jest członkiem grupy określonej przez typ tożsamości i wartość.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Save()

Zapisuje zmiany wprowadzone w obiekcie Principal do magazynu.Saves the changes that were made on the principal object to the store. Jeśli jest to nowy obiekt Principal, ta metoda wstawia go do sklepu.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext)

Zapisuje zmiany wprowadzone w obiekcie Principal do magazynu.Saves the changes that were made on the principal object to the store. Jeśli jest to nowy obiekt Principal, ta metoda wstawia je do określonego kontekstu.If this is a new principal object, this method inserts it into the specified context. Jeśli podmiot zabezpieczeń został już utrwalony, jest przenoszony z oryginalnego kontekstu do określonego kontekstu.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString()

Zwraca przyjazny dla użytkownika ciąg reprezentujący bieżący obiekt Principal.Returns a user friendly string representation of the current principal object.

Dotyczy