PrincipalCollection.Add Метод

Определение

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

Перегрузки

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
Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
Public Sub Add (computer As ComputerPrincipal)

Параметры

computer
ComputerPrincipal

Объект ComputerPrincipal.

Атрибуты

Комментарии

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

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

Применяется к

Add(GroupPrincipal)

Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
Public Sub Add (group As GroupPrincipal)

Параметры

group
GroupPrincipal

Объект ComputerPrincipal.

Атрибуты

Комментарии

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

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

Применяется к

Add(Principal)

Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs

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

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
[<System.Security.SecurityCritical>]
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.

Реализации

Атрибуты

Комментарии

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

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

Применяется к

Add(UserPrincipal)

Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs
Исходный код:
PrincipalCollection.cs

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

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
[<System.Security.SecurityCritical>]
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
Исходный код:
PrincipalCollection.cs
Исходный код:
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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 является пустой строкой.

Применяется к