Principal Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инкапсулирует данные и операции учетной записи, общие для всех субъектов безопасности. Это абстрактный базовый класс, от которого производны все субъекты безопасности.
public ref class Principal abstract : IDisposablepublic abstract class Principal : IDisposabletype Principal = class
interface IDisposablePublic MustInherit Class Principal
Implements IDisposable- Наследование
-
Principal
- Производный
- Реализации
Комментарии
Пользовательские классы расширений, производные от этого класса, могут вызывать этот конструктор из конструктора производных классов для инициализации базового класса.
Конструкторы
| Имя | Описание |
|---|---|
| Principal() |
Инициализирует новый экземпляр класса Principal. Этот конструктор вызывается конструкторами производных классов для инициализации базового класса и не предназначен для вызова непосредственно из кода. |
Свойства
| Имя | Описание |
|---|---|
| Context |
Возвращает контекст субъекта, связанный с субъектом. |
| ContextRaw |
Возвращает контекст субъекта, связанный с этим субъектом. |
| ContextType |
Возвращает значение перечисления типа контекста, указывающее тип контекста субъекта, связанного с этим субъектом. |
| Description |
Возвращает или задает описание субъекта. |
| DisplayName |
Возвращает или задает отображаемое имя для этого субъекта. |
| DistinguishedName |
Получает различающееся имя (DN) для этого субъекта. |
| Guid |
Возвращает GUID, связанный с этим субъектом. |
| Name |
Возвращает или задает имя этого субъекта. |
| SamAccountName |
Возвращает или задает имя учетной записи SAM для этого субъекта. |
| Sid |
Возвращает идентификатор безопасности (SID) субъекта. |
| StructuralObjectClass |
Возвращает атрибут каталога классов структурных объектов. |
| UserPrincipalName |
Возвращает или задает имя участника-пользователя, связанное с этим субъектом. |
Методы
| Имя | Описание |
|---|---|
| CheckDisposedOrDeleted() |
Определяет, вызываются ли Dispose()Delete() методы для этого класса. Этот метод вызывается классами, производными от этого основного класса. |
| Delete() |
Удаляет основной объект из хранилища. |
| Dispose() |
Удаляет текущий Principal экземпляр объекта. |
| Equals(Object) |
Возвращает логическое значение, указывающее, равен ли предоставленный объект текущему объекту. |
| ExtensionGet(String) |
Извлекает атрибут объекта расширенного класса. |
| ExtensionSet(String, Object) |
Задает значение атрибута в расширенном классе. |
| FindByIdentity(PrincipalContext, IdentityType, String) |
Возвращает основной объект, соответствующий указанному типу удостоверения и значению. Эта версия FindByIdentity(PrincipalContext, IdentityType, String) метода определяет формат значения удостоверения. |
| FindByIdentity(PrincipalContext, String) |
Возвращает основной объект, соответствующий указанному значению удостоверения. |
| FindByIdentityWithType(PrincipalContext, Type, IdentityType, String) |
Возвращает основной объект, соответствующий указанному типу удостоверения и значению. Этот метод вызывается реализацией метода FindByIdentity производного класса, чтобы ограничить поиск производным типом класса и не должен вызываться непосредственно из кода. |
| FindByIdentityWithType(PrincipalContext, Type, String) |
Возвращает основной объект, соответствующий указанному типу удостоверения и значению. Этот метод вызывается реализацией метода FindByIdentity производного класса, чтобы ограничить поиск производным типом класса и не должен вызываться непосредственно из кода. |
| GetGroups() |
Возвращает коллекцию объектов группы, которые указывают группы, из которых текущий субъект является членом. |
| GetGroups(PrincipalContext) |
Возвращает коллекцию объектов группы, из которых субъект является членом и который существует в хранилище, предоставленном указанным параметром контекста. |
| GetHashCode() |
Извлекает хэш, созданный из содержимого основного объекта, подходящего для использования в хэш-алгоритмах и структурах данных, таких как хэш-таблица. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetUnderlyingObject() |
Возвращает базовый DirectoryEntry объект, предоставляющий контактные данные для основного объекта. |
| GetUnderlyingObjectType() |
Возвращает базовый тип объекта. |
| IsMemberOf(GroupPrincipal) |
Возвращает логическое значение, указывающее, является ли субъект членом указанной группы. |
| IsMemberOf(PrincipalContext, IdentityType, String) |
Возвращает логическое значение, указывающее, является ли субъект членом группы, указанной типом удостоверения и значением. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Save() |
Сохраняет изменения, внесенные в основной объект в хранилище. Если это новый основной объект, этот метод вставляет его в хранилище. |
| Save(PrincipalContext) |
Сохраняет изменения, внесенные в основной объект в хранилище. Если это новый основной объект, этот метод вставляет его в указанный контекст. Если субъект уже сохранен, он перемещается из исходного контекста в указанный контекст. |
| ToString() |
Возвращает понятное строковое представление текущего основного объекта. |
