DirectoryContext Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Класс DirectoryContext идентифицирует указанный каталог и учетные данные, используемые для доступа к каталогу.
public ref class DirectoryContext
public class DirectoryContext
type DirectoryContext = class
Public 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 | Forest | DNS-имя леса, например, corp.fabrikam.com. |
| Раздел приложения | ApplicationPartition | DNS-имя раздела приложения. |
| Набор конфигурации AD LDS | ConfigurationSet | Одно из ключевых слов, связанных с точкой подключения службы, зарегистрированной экземплярами AD LDS для набора конфигурации. |
Конструкторы
| DirectoryContext(DirectoryContextType) |
Инициализирует новый экземпляр класса DirectoryContext указанного типа, который содержит учетные данные текущего контекста пользователя. |
| DirectoryContext(DirectoryContextType, String) |
Инициализирует новый экземпляр класса DirectoryContext указанного типа, который содержит указанное имя и учетные данные текущего контекста пользователя. |
| DirectoryContext(DirectoryContextType, String, String) |
Инициализирует новый экземпляр класса DirectoryContext указанного типа, который содержит указанные имя пользователя и пароль. |
| DirectoryContext(DirectoryContextType, String, String, String) |
Инициализирует новый экземпляр класса DirectoryContext указанного типа, который содержит указанные цель, имя пользователя и пароль. |
Свойства
| ContextType |
Возвращает тип объекта контекста. |
| Name |
Возвращает имя контекста. |
| UserName |
Возвращает имя пользователя контекста. |
Методы
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |