PrincipalCollection.Remove Метод

Определение

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

System.DirectoryServices.AccountManagement

Сборка:

System.DirectoryServices.AccountManagement.dll

Пакет:

System.DirectoryServices.AccountManagement v8.0.0

Удаляет указанного участника из коллекции и возвращает значение true, если указанный объект-участник являлся элементом коллекции, или значение false в противном случае (в этом случае операция не выполняется).

Перегрузки

Remove(ComputerPrincipal)	Удаляет указанный объект ComputerPrincipal из коллекции и возвращает значение true, если указанный объект-участник ComputerPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).
Remove(GroupPrincipal)	Удаляет указанный объект GroupPrincipal из коллекции и возвращает значение true, если указанный объект-участник GroupPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).
Remove(Principal)	Удаляет указанный объект Principal из коллекции и возвращает значение true, если указанный объект-участник Principal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).
Remove(UserPrincipal)	Удаляет указанный объект UserPrincipal из коллекции и возвращает значение true, если указанный объект-участник UserPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).
Remove(PrincipalContext, IdentityType, String)	Ищет объект UserPrincipal, заданный указанным контекстом PrincipalContext и парой значений identityType/identityValue из коллекции, и возвращает значение true, если указанный объект-участник Principal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

Комментарии

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

Remove(ComputerPrincipal)

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

PrincipalCollection.cs

Удаляет указанный объект ComputerPrincipal из коллекции и возвращает значение true, если указанный объект-участник ComputerPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

public:
 bool Remove(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public bool Remove (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Remove (computer As ComputerPrincipal) As Boolean

Параметры

computer

ComputerPrincipal

Объект ComputerPrincipal.

Возвращаемое значение

Boolean

Значение true, если объект ComputerPrincipal был членом этой PrincipalCollection, в противном случае — значение false.

Комментарии

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

Исключение	Описание
InvalidOperationException	Этот метод был вызван в Members коллекции для группы доменов, и удаляемый субъект домена является членом группы в силу ее primaryGroupId атрибута.

Remove(GroupPrincipal)

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

PrincipalCollection.cs

Удаляет указанный объект GroupPrincipal из коллекции и возвращает значение true, если указанный объект-участник GroupPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

public:
 bool Remove(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public bool Remove (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Remove (group As GroupPrincipal) As Boolean

Параметры

group

GroupPrincipal

Объект GroupPrincipal.

Возвращаемое значение

Boolean

Значение true, если объект GroupPrincipal был членом этой PrincipalCollection, в противном случае — значение false.

Комментарии

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

Исключение	Описание
InvalidOperationException	Этот метод был вызван в Members коллекции для группы доменов, и удаляемый субъект домена является членом группы в силу ее primaryGroupId атрибута.

Remove(Principal)

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

PrincipalCollection.cs

Удаляет указанный объект Principal из коллекции и возвращает значение true, если указанный объект-участник Principal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

public:
 virtual bool Remove(System::DirectoryServices::AccountManagement::Principal ^ principal);

public bool Remove (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Remove : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Remove : System.DirectoryServices.AccountManagement.Principal -> bool

Public Function Remove (principal As Principal) As Boolean

Параметры

principal

Principal

Объект Principal.

Возвращаемое значение

Boolean

Значение true, если объект Principal был членом этой PrincipalCollection, в противном случае — значение false.

Реализации

Remove(T)

Комментарии

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

Исключение	Описание
InvalidOperationException	Этот метод был вызван в Members коллекции для группы доменов, и удаляемый субъект домена является членом группы в силу ее primaryGroupId атрибута.

Remove(UserPrincipal)

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

PrincipalCollection.cs

Удаляет указанный объект UserPrincipal из коллекции и возвращает значение true, если указанный объект-участник UserPrincipal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

public:
 bool Remove(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public bool Remove (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Remove (user As UserPrincipal) As Boolean

Параметры

user

UserPrincipal

Объект UserPrincipal.

Возвращаемое значение

Boolean

Значение true, если объект UserPrincipal был членом этой PrincipalCollection, в противном случае — значение false.

Комментарии

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

Исключение	Описание
InvalidOperationException	Этот метод был вызван в Members коллекции для группы доменов, и удаляемый субъект домена является членом группы в силу ее primaryGroupId атрибута.

Remove(PrincipalContext, IdentityType, String)

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

PrincipalCollection.cs

Ищет объект UserPrincipal, заданный указанным контекстом PrincipalContext и парой значений identityType/identityValue из коллекции, и возвращает значение true, если указанный объект-участник Principal являлся элементом коллекции PrincipalCollection, или значение false в противном случае (в этом случае операция не выполняется).

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

public bool Remove (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Remove : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> bool

Public Function Remove (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Boolean

Параметры

context

PrincipalContext

Объект PrincipalContext.

identityType

IdentityType

Значение IdentityType, определяющее формат identityValue.

identityValue

String

Строка.

Возвращаемое значение

Boolean

Значение true, если идентифицированный объект Principal был членом этой PrincipalCollection, в противном случае — значение false.

Комментарии

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

Исключение	Описание
InvalidOperationException	Этот метод был вызван в Members коллекции для группы доменов, и удаляемый субъект домена является членом группы в силу ее primaryGroupId атрибута.
NoMatchingPrincipalException	Субъект, соответствующий указанным параметрам, не найден.
MultipleMatchesException	Несколько субъектов соответствуют указанным параметрам. Теоретически этого не должно происходить, так как Add вызывает исключение при попытке добавить повторяющиеся субъекты в коллекцию. Однако вполне возможно, что дубликат был создан другим API.
ArgumentException	Параметр identityType равен пустой строке.