DirectoryContext Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Класс DirectoryContext определяет определенный каталог и учетные данные, используемые для доступа к каталогу.
public ref class DirectoryContextpublic class DirectoryContexttype DirectoryContext = classPublic Class DirectoryContext- Наследование
-
DirectoryContext
Комментарии
Перед доступом к методам и свойствам объекта каталога System.DirectoryServices.ActiveDirectory, например домена или леса, необходимо создать контекст каталога.
При создании контекста каталога текущие учетные данные процесса или альтернативные учетные данные можно применить к данному контексту с помощью соответствующего конструктора. Эти учетные данные определяют разрешения, действующие при обращении программы к объектам каталога. Так как доменные службы Active Directory объекты могут быть защищены от извлечения или изменения пользователями, не являющихся административными, использование альтернативных учетных данных с разрешением на доступ к целевым объектам иногда требуется для правильной работы программы.
В следующей таблице содержится список разрешенных типов целевых типов и описание формата целевой строки.
| Тип целевого объекта | ЧленDirectoryContextType | Формат целевого имени |
|---|---|---|
| Контроллер домена | DirectoryServer | DNS-имя контроллера домена. |
| Экземпляр AD LDS | DirectoryServer | DNS-имя сервера AD LDS и номера порта LDAP, например ad_lds_instance.fabrikam.com:389. |
| Домен | Domain | DNS-имя домена, например, sales.corp.fabrikam.com. |
| Лес | Forest | DNS-имя леса, например, corp.fabrikam.com. |
| Раздел приложения | ApplicationPartition | DNS-имя секции приложения. |
| Набор конфигураций AD LDS | ConfigurationSet | Одно из ключевых слов, связанных с точкой подключения службы, зарегистрированной экземплярами AD LDS для набора конфигурации. |
Конструкторы
| Имя | Описание |
|---|---|
| DirectoryContext(DirectoryContextType, String, String, String) |
Инициализирует новый экземпляр DirectoryContext класса указанного типа, содержащего указанный целевой объект, имя пользователя и пароль. |
| DirectoryContext(DirectoryContextType, String, String) |
Инициализирует новый экземпляр DirectoryContext класса указанного типа, содержащего указанное имя пользователя и пароль. |
| DirectoryContext(DirectoryContextType, String) |
Инициализирует новый экземпляр DirectoryContext класса указанного типа, содержащего указанное имя и учетные данные текущего контекста пользователя. |
| DirectoryContext(DirectoryContextType) |
Инициализирует новый экземпляр DirectoryContext класса указанного типа, содержащего учетные данные текущего контекста пользователя. |
Свойства
| Имя | Описание |
|---|---|
| ContextType |
Возвращает тип объекта контекста. |
| Name |
Возвращает имя контекста. |
| UserName |
Возвращает имя пользователя контекста. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
