Principal Класс

Определение

Инкапсулирует данные и операции учетной записи, общие для всех участников безопасности.Encapsulates the account data and operations common to all security principals. Это абстрактный базовый класс, от которого наследуются все участники безопасности.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
Наследование
Principal
Производный
Реализации

Комментарии

Пользовательские классы расширений, производные от этого класса, могут вызывать этот конструктор из конструктора производного класса для инициализации базового класса.Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. Дополнительные сведения см. в разделе Общие сведения о расширениях основных модулей .For more information, see the Principal Extensions overview topic.

Конструкторы

Principal()

Инициализирует новый экземпляр класса Principal.Initializes a new instance of the Principal class. Это конструктор вызывается конструкторами производного класса для инициализации базового класса и не предназначен для непосредственного вызова в прикладном коде.This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

Свойства

Context

Возвращает контекст участника, который связан с этим участником.Gets a principal context that is associated with the principal.

ContextRaw

Возвращает контекст участника, который связан с этим участником.Gets a principal context that is associated with this principal.

ContextType

Возвращает значение перечисления типов контекста, указывающее тип контекста участника, связанный с этим участником.Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description

Получает или задает описание участника.Gets or sets the description of the principal.

DisplayName

Получает или задает отображаемое имя участника.Gets or sets the display name for this principal.

DistinguishedName

Возвращает различающееся имя (DN) участника.Gets the distinguished name (DN) for this principal.

Guid

Возвращает идентификатор GUID, связанный с участником.Gets the GUID associated with this principal.

Name

Получает или задает имя участника.Gets or sets the name of this principal.

SamAccountName

Получает или задает имя учетной записи SAM для данного участника.Gets or sets the SAM account name for this principal.

Sid

Возвращает идентификатор безопасности участника.Gets the Security ID (SID) of the principal.

StructuralObjectClass

Возвращает атрибут каталога класса структурного объекта.Gets the structural object class directory attribute.

UserPrincipalName

Возвращает или указывает имя участника-пользователя (UPN), связанное с этим субъектом.Gets or sets the user principal name (UPN) associated with this principal.

Методы

CheckDisposedOrDeleted()

Определяет, был ли вызван для этого класса метод Dispose() или Delete().Determines whether the Dispose() or Delete() methods have been called on this class. Этот метод вызывается классами, производными от класса данного участника.This method is called by classes that derive from this principal class.

Delete()

Удаляет объект-участник из хранилища.Deletes the principal object from the store.

Dispose()

Удаляет текущий экземпляр объекта Principal.Disposes the current instance of the Principal object.

Equals(Object)

Возвращает логическое значение, указывающее, равен ли заданный объект текущему.Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String)

Извлекает атрибут объекта расширенного класса.Retrieves an attribute of an extended class object.

ExtensionSet(String, Object)

Задает значение атрибута в расширенном классе.Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String)

Возвращает объект-субъект, соответствующий заданному типу и значению удостоверения.Returns a principal object that matches the specified identity type, and value. Эта версия метода FindByIdentity(PrincipalContext, IdentityType, String) определяет формат значения удостоверения.This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

Возвращает объект-участник, соответствующий заданному значению удостоверения.Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

Возвращает объект-субъект, соответствующий заданному типу и значению удостоверения.Returns a principal object that matches the specified identity type, and value. Этот метод вызывается в реализации метода производного класса FindByIdentity для ограничения поиска типом производного класса и не предназначен для непосредственного вызова в коде.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)

Возвращает объект-субъект, соответствующий заданному типу и значению удостоверения.Returns a principal object that matches the specified identity type, and value. Этот метод вызывается в реализации метода производного класса FindByIdentity для ограничения поиска типом производного класса и не предназначен для непосредственного вызова в коде.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()

Возвращает коллекцию объектов групп, указывающих группы, в которые входит текущий участник.Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext)

Возвращает коллекцию объектов групп, в которые входит участник и которые существуют в хранилище, заданном в параметре контекста.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()

Извлекает хэш, созданный из содержимого объекта-участника, который подходит для использования в алгоритмах хэширования и структурах данных, таких как хэш-таблица.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()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUnderlyingObject()

Возвращает базовый объект DirectoryEntry, который предоставляет контактные данные для объекта субъекта.Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType()

Возвращает базовый тип объекта.Returns the underlying object type.

IsMemberOf(GroupPrincipal)

Возвращает логическое значение, указывающее, входит ли участник в указанную группу.Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String)

Возвращает логическое значение, указывающее, входит ли участник в группу, заданную типом и значением удостоверения.Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Save()

Сохраняет изменения объекта-участника в хранилище.Saves the changes that were made on the principal object to the store. Если это новый объект-участник, метод помещает его в хранилище.If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext)

Сохраняет изменения объекта-участника в хранилище.Saves the changes that were made on the principal object to the store. Если это новый объект-участник, метод помещает его в указанный контекст.If this is a new principal object, this method inserts it into the specified context. Если участник уже сохранен, он перемещается из исходного контекста в указанный.If the principal has already been persisted, it is moved from the original context to the specified context.

ToString()

Возвращает понятное строковое представление текущего объекта-участника.Returns a user friendly string representation of the current principal object.

Применяется к