PrincipalCollection.Add Метод

Определение

Пространство имен:

System.DirectoryServices.AccountManagement

Сборка:

System.DirectoryServices.AccountManagement.dll

Пакет:

System.DirectoryServices.AccountManagement v8.0.0

Добавляет заданного участника в конец коллекции.

Перегрузки

Add(ComputerPrincipal)	Добавляет заданный объект ComputerPrincipal в конец коллекции.
Add(GroupPrincipal)	Добавляет заданный объект GroupPrincipal в конец коллекции.
Add(Principal)	Добавляет заданный объект Principal в конец коллекции.
Add(UserPrincipal)	Добавляет заданный объект UserPrincipal в конец коллекции.
Add(PrincipalContext, IdentityType, String)	Осуществляет поиск объекта Principal, соответствующего параметрам, и добавляет его в конец коллекции.

Комментарии

Как и в случае с Remove , Containsэта функция имеет четыре перегрузки, но все они выполняют одно и то же. Дополнительные перегрузки реализуются только для повышения удобства использования, чтобы разработчики, использующие IntelliSense, видели перегрузки, которые принимают UserPrincipalобъект , GroupPrincipalили ComputerPrincipal . Вызов любой из перегрузок пользователя, группы или компьютера в точности эквивалентен вызову перегрузки Principal .

Add(ComputerPrincipal)

Исходный код:

PrincipalCollection.cs

Добавляет заданный объект ComputerPrincipal в конец коллекции.

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit

Public Sub Add (computer As ComputerPrincipal)

Параметры

computer

ComputerPrincipal

Объект ComputerPrincipal.

Комментарии

Эта функция может вызывать следующие исключения:

Исключение	Описание
PrincipalExistsException	Элемент computer уже присутствует в коллекции.

Add(GroupPrincipal)

Исходный код:

PrincipalCollection.cs

Добавляет заданный объект GroupPrincipal в конец коллекции.

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit

Public Sub Add (group As GroupPrincipal)

Параметры

group

GroupPrincipal

Объект ComputerPrincipal.

Комментарии

Эта функция может вызывать следующие исключения:

Исключение	Описание
PrincipalExistsException	Элемент group уже присутствует в коллекции.

Add(Principal)

Исходный код:

PrincipalCollection.cs

Добавляет заданный объект Principal в конец коллекции.

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);

public void Add (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit

Public Sub Add (principal As Principal)

Параметры

principal

Principal

Объект Principal.

Реализации

Add(T)

Комментарии

Эта функция может вызывать следующие исключения:

Исключение	Описание
PrincipalExistsException	Элемент principal уже присутствует в коллекции.

Add(UserPrincipal)

Исходный код:

PrincipalCollection.cs

Добавляет заданный объект UserPrincipal в конец коллекции.

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit

Public Sub Add (user As UserPrincipal)

Параметры

user

UserPrincipal

Объект UserPrincipal.

Комментарии

Эта функция может вызывать следующие исключения:

Исключение	Описание
PrincipalExistsException	Элемент user уже присутствует в коллекции.

Add(PrincipalContext, IdentityType, String)

Исходный код:

PrincipalCollection.cs

Осуществляет поиск объекта Principal, соответствующего параметрам, и добавляет его в конец коллекции.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit

Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

Параметры

context

PrincipalContext

Объект PrincipalContext для добавляемого в коллекцию участника.

identityType

IdentityType

Объект IdentityType , указывающий формат identityValue.

identityValue

String

Строка, идентифицирующая субъект в формате, заданном параметром identityType.

Комментарии

Эта функция может вызывать следующие исключения:

Исключение	Описание
PrincipalExistsException	Субъект, соответствующий этим параметрам, уже существует в коллекции.
NoMatchingPrincipalException	Субъект, соответствующий указанным параметрам, не найден.
MultipleMatchesException	Указанные параметры соответствуют нескольким субъектам.
ArgumentException	identityType является пустой строкой.