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 строка может иметь различные форматы. Для поддерживаются три параметра NameFormat: Nt4Name, UserPrincipalName и SamAccountName. Дополнительные сведения о форматах имен см. в документации по ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Исходный код:
- 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
Инициализирует новый экземпляр класса 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
Исключения
Имя должно быть задано, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Применяется к
PrincipalContext(ContextType, String, String)
- Исходный код:
- 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
- container
- String
Контейнер хранилища, используемый в качестве корня контекста. Все запросы выполняются по отношению к этому корню, а все данные добавляются в этот контейнер.
Для типов контекста Domain и ApplicationDirectory данный параметр принимает значение различающегося имени объекта-контейнера.
Этот параметр должен иметь значение null для типов контекста Machine.
Исключения
Контейнер нельзя задать, если в параметре contextType указан тип контекста Machine.
Параметр name или container должен быть задан, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Комментарии
Может InvalidOperationException вызываться при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для контекста Domain субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого содержит основные классы пользователя, группы или компьютера в атрибуте possibleInferiors.
Применяется к
PrincipalContext(ContextType, String, String, ContextOptions)
- Исходный код:
- 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
- container
- String
Контейнер хранилища, используемый в качестве корня контекста. Все запросы выполняются по отношению к этому корню, а все данные добавляются в этот контейнер.
Для типов контекста Domain и ApplicationDirectory данный параметр принимает значение различающегося имени объекта-контейнера.
Этот параметр должен иметь значение null для типов контекста Machine.
- options
- ContextOptions
Сочетание одного или нескольких значений перечисления ContextOptions, задающих параметры, которые используются для привязки к серверу. Если этот параметр имеет значение null, используются следующие параметры по умолчанию: ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Исключения
Контейнер нельзя задать, если в параметре contextType указан тип контекста Machine.
Параметр name или container должен быть задан, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Параметр options содержит сочетание недопустимых значений перечисления ContextOptions.
Комментарии
Может InvalidOperationException вызываться при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для контекста Domain субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого содержит основные классы пользователя, группы или компьютера в атрибуте possibleInferiors.
Применяется к
PrincipalContext(ContextType, String, String, String)
- Исходный код:
- 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
- userName
- String
Имя пользователя для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные текущего процесса. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
- password
- String
Пароль для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные текущего процесса. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
Исключения
Параметры username и password должны либо быть равными null, либо содержать значение.
Имя должно быть задано, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Применяется к
PrincipalContext(ContextType, String, String, String, String)
- Исходный код:
- 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
- container
- String
Контейнер хранилища, используемый в качестве корня контекста. Все запросы выполняются по отношению к этому корню, а все данные добавляются в этот контейнер.
Для типов контекста Domain и ApplicationDirectory данный параметр принимает значение различающегося имени объекта-контейнера.
Этот параметр должен иметь значение null для типов контекста Machine.
- userName
- String
Имя пользователя для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные по умолчанию для текущего субъекта. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
- password
- String
Пароль для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные по умолчанию для текущего субъекта. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
Исключения
Параметры username и password должны либо быть равными null, либо содержать значение.
Контейнер нельзя задать, если в параметре contextType указан тип контекста Machine.
Параметр name или container должен быть задан, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Комментарии
Может InvalidOperationException вызываться при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для контекста Domain субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого содержит основные классы пользователя, группы или компьютера в атрибуте possibleInferiors.
Применяется к
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Исходный код:
- 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
Имя домена или сервера для типов контекста Domain, имя компьютера для типов контекста Machine или имя и порт сервера, на котором размещен экземпляр объекта ApplicationDirectory.
Если имя типа контекста Domain имеет значение null, этот контекст является контроллером домена для домена субъекта-пользователя, от имени которого запущен поток. Если имя типа контекста Machine имеет значение null, это имя локального компьютера. Этот параметр не может принимать значение null для типов контекста ApplicationDirectory.
- container
- String
Контейнер хранилища, используемый в качестве корня контекста. Все запросы выполняются по отношению к этому корню, а все данные добавляются в этот контейнер.
Для типов контекста Domain и ApplicationDirectory данный параметр принимает значение различающегося имени объекта-контейнера.
Этот параметр должен иметь значение null для типов контекста Machine.
- options
- ContextOptions
Сочетание одного или нескольких значений перечисления ContextOptions, задающих параметры, которые используются для привязки к серверу. Если этот параметр имеет значение null, используются следующие параметры по умолчанию: ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Имя пользователя для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные по умолчанию для текущего субъекта. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
- password
- String
Пароль для подключения к хранилищу. Если оба параметра userName и password имеют значение null, используются учетные данные по умолчанию для текущего субъекта. В противном случае оба параметра userName и password должны иметь значения, не равные NULL, а указанные в них учетные данные используются для подключения к хранилищу.
Исключения
Параметры username и password должны либо быть равными null, либо содержать значение.
Контейнер нельзя задать, если в параметре contextType указан тип контекста Machine.
Параметр name или container должен быть задан, если в параметре contextType указан тип контекста ApplicationDirectory.
Параметр contextType содержит недопустимое значение перечисления ContextType.
Параметр options содержит сочетание недопустимых значений перечисления ContextOptions.
Комментарии
Может InvalidOperationException вызываться при последующих вызовах операций каталога, которые подключаются к серверу, если контейнер, указанный для контекста Domain субъекта, не является допустимым контейнером. Контейнер определяется как объект, класс схемы которого содержит основные классы пользователя, группы или компьютера в атрибуте possibleInferiors.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по