PrincipalContext Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса PrincipalContext.
Перегрузки
| Имя | Описание |
|---|---|
| PrincipalContext(ContextType) |
Инициализирует новый экземпляр PrincipalContext класса с указанным типом контекста. |
| PrincipalContext(ContextType, String) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext и именем. |
| PrincipalContext(ContextType, String, String) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем и контейнером. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером и параметрами контекста. |
| PrincipalContext(ContextType, String, String, String) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, именем пользователя и паролем. |
| PrincipalContext(ContextType, String, String, String, String) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером, именем пользователя и паролем. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером, параметрами контекста, именем пользователя и паролем. |
Комментарии
PrincipalContext Конструкторы выполняют проверку параметров и сервера, но не пытаются проверить учетные данные.
Если объект контекста субъекта создается без указания контейнера, его можно использовать для представления нескольких отдельных контейнеров. Один контейнер может использоваться в качестве базы операций запроса, а дополнительные контейнеры могут содержать только что созданные объекты-субъекты. Например, когда пользователи или группы вставляются в тип контекста домена, API управления учетными записями использует известный по умолчанию контейнер пользователя CN=Users, DC=Fabrikam, DC=com. При вставке компьютеров в хранилище API используется контейнер по умолчанию "CN=Computers,DC=Fabrikam,DC=com". Обратите внимание, что имена контейнеров по умолчанию могут быть изменены администратором домена. Так как конструкторы основных объектов могут указывать только один контекст субъекта, дополнительные контексты предоставляются в качестве поведения по умолчанию, когда приложение создает контекст домена без указания контейнера. Так как каталог приложений не имеет известных контейнеров, приложение должно указать контейнер в конструкторе или ArgumentException создается. Так как SAM не содержит контейнеров, создается исключение, ArgumentException если приложение пытается указать контейнер в конструкторе.
В каждой версии конструктора, который принимает имя пользователя в качестве параметра, userName строка может находиться в разных форматах. Для них поддерживаются три поддерживаемых элемента NameFormats: Nt4Name, UserPrincipalName и SamAccountName. Дополнительные сведения о форматах имен см. в документации по ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр PrincipalContext класса с указанным типом контекста.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
Исключения
Имя или контейнер необходимо указать при использовании контекста каталога приложения.
Параметр contextType не содержит допустимое ContextType значение перечисления.
Применяется к
PrincipalContext(ContextType, String)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext и именем.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
Исключения
Имя должно быть указано, если ApplicationDirectory указан параметр contextType .
Параметр contextType не содержит допустимое ContextType значение перечисления.
Применяется к
PrincipalContext(ContextType, String, String)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем и контейнером.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
- container
- String
Контейнер в хранилище, используемый в качестве корневого каталога контекста. Все запросы выполняются в этом корневом каталоге, и все вставки выполняются в этот контейнер.
Для Domain типов ApplicationDirectory контекста этот параметр представляет собой различающееся имя объекта контейнера.
Для Machine типов контекста этот параметр должен иметь значение null.
Исключения
Контейнер нельзя указать, если Machine в параметре указан тип контекста contextType .
При указании имени или контейнера в параметре ApplicationDirectory необходимо указать contextType имя или контейнер.
Параметр contextType не содержит допустимое ContextType значение перечисления.
Комментарии
Может InvalidOperationException возникать при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для Domain контекста субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого имеет основные классы( пользователь, группа или компьютер) в его возможном атрибутеInferiors.
Применяется к
PrincipalContext(ContextType, String, String, ContextOptions)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером и параметрами контекста.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
- container
- String
Контейнер в хранилище, используемый в качестве корневого каталога контекста. Все запросы выполняются в этом корневом каталоге, и все вставки выполняются в этот контейнер.
Для Domain типов ApplicationDirectory контекста этот параметр представляет собой различающееся имя объекта контейнера.
Для Machine типов контекста этот параметр должен иметь значение null.
- options
- ContextOptions
Сочетание одного или нескольких ContextOptions значений перечисления, указывающее параметры, используемые для привязки к серверу. Если этот параметр задан null, параметры по умолчанию — ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Исключения
Контейнер нельзя указать, если Machine в параметре указан тип контекста contextType .
При указании имени или контейнера в параметре ApplicationDirectory необходимо указать contextType имя или контейнер.
Параметр contextType не содержит допустимое ContextType значение перечисления.
Параметр options не содержит сочетания допустимых ContextOptions значений перечисления.
Комментарии
Может InvalidOperationException возникать при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для Domain контекста субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого имеет основные классы( пользователь, группа или компьютер) в его возможном атрибутеInferiors.
Применяется к
PrincipalContext(ContextType, String, String, String)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, именем пользователя и паролем.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ userName, System::String ^ password);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, userName As String, password As String)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
- userName
- String
Имя пользователя, используемое для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные текущего процесса.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
- password
- String
Пароль, используемый для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные текущего процесса.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
Исключения
Значения userName и password параметры должны быть null или содержать значение.
Имя должно быть указано, если ApplicationDirectory указан параметр contextType .
Параметр contextType не содержит допустимое ContextType значение перечисления.
Применяется к
PrincipalContext(ContextType, String, String, String, String)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером, именем пользователя и паролем.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::String ^ userName, System::String ^ password);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
- container
- String
Контейнер в хранилище, используемый в качестве корневого каталога контекста. Все запросы выполняются в этом корневом каталоге, и все вставки выполняются в этот контейнер.
Для Domain типов ApplicationDirectory контекста этот параметр представляет собой различающееся имя объекта контейнера.
Для Machine типов контекста этот параметр должен иметь значение null.
- userName
- String
Имя пользователя, используемое для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные по умолчанию текущего субъекта.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
- password
- String
Пароль, используемый для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные по умолчанию текущего субъекта.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
Исключения
Значения userName и password параметры должны быть null или содержать значение.
Контейнер нельзя указать, если Machine в параметре указан тип контекста contextType .
Значение или namecontainer должно быть указано при ApplicationDirectory указании в параметреcontextType.
Параметр contextType не содержит допустимое ContextType значение перечисления.
Комментарии
Может InvalidOperationException возникать при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для Domain контекста субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого имеет основные классы( пользователь, группа или компьютер) в его возможном атрибутеInferiors.
Применяется к
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
- Исходный код:
- Context.cs
Инициализирует новый экземпляр класса с указанным типом контекста PrincipalContext , именем, контейнером, параметрами контекста, именем пользователя и паролем.
public:
PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options, System::String ^ userName, System::String ^ password);public PrincipalContext(System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options, string userName, string password);new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions * string * string -> System.DirectoryServices.AccountManagement.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)Параметры
- contextType
- ContextType
ContextType Значение перечисления, указывающее тип хранилища для контекста субъекта.
- name
- String
Имя домена или сервера для типов контекста, имя компьютера для DomainMachine типов контекста или имя сервера и порта, на котором размещен ApplicationDirectory экземпляр.
Если имя предназначено null для типа контекста Domain , это контроллер домена для домена субъекта-пользователя, в котором выполняется поток. Если имя предназначено null для типа контекста, это имя локального Machine компьютера. Этот параметр не может быть null для ApplicationDirectory типов контекста.
- container
- String
Контейнер в хранилище, используемый в качестве корневого каталога контекста. Все запросы выполняются в этом корневом каталоге, и все вставки выполняются в этот контейнер.
Для Domain типов ApplicationDirectory контекста этот параметр представляет собой различающееся имя объекта контейнера.
Для Machine типов контекста этот параметр должен иметь значение null.
- options
- ContextOptions
Сочетание одного или нескольких ContextOptions значений перечисления, используемых для привязки к серверу. Если этот параметр задан null, параметры по умолчанию — ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Имя пользователя, используемое для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные по умолчанию текущего субъекта.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
- password
- String
Пароль, используемый для подключения к хранилищу. Если оба userName параметра являются passwordnull, используются учетные данные по умолчанию текущего субъекта.
userName В противном случае оба значения и password должны быть не null, а указанные учетные данные используются для подключения к хранилищу.
Исключения
Значения userName и password параметры должны быть null или содержать значение.
Контейнер нельзя указать, если Machine в параметре указан тип контекста contextType .
При указании имени или контейнера в параметре ApplicationDirectory необходимо указать contextType имя или контейнер.
Параметр contextType не содержит допустимое ContextType значение перечисления.
Параметр options не содержит сочетания допустимых ContextOptions значений перечисления.
Комментарии
Может InvalidOperationException возникать при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для Domain контекста субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого имеет основные классы( пользователь, группа или компьютер) в его возможном атрибутеInferiors.
