PrincipalCollection.Remove Метод

Определение

Пространство имен:: System.DirectoryServices.AccountManagement

Сборка:: System.DirectoryServices.AccountManagement.dll

Пакет:: System.DirectoryServices.AccountManagement v11.0.0-preview.4.26230.115

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Удаляет указанный субъект из коллекции и возвращает 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

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

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

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

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

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

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

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

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Remove (computer As ComputerPrincipal) As Boolean

Параметры

computer: ComputerPrincipal

Объект ComputerPrincipal.

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

Boolean

trueЗначение , ComputerPrincipalесли он PrincipalCollection был членом этогоfalse; в противном случае .

Атрибуты: SecurityCriticalAttribute

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

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

Remove(GroupPrincipal)

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

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

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

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

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

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

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.GroupPrincipal group);

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

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Remove (group As GroupPrincipal) As Boolean

Параметры

group: GroupPrincipal

Объект GroupPrincipal.

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

Boolean

trueЗначение , GroupPrincipalесли он PrincipalCollection был членом этогоfalse; в противном случае .

Атрибуты: SecurityCriticalAttribute

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

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

Remove(Principal)

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

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

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

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

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

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

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.Principal principal);

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

[<System.Security.SecurityCritical>]
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)

Атрибуты: SecurityCriticalAttribute

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

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

Remove(UserPrincipal)

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

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

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

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

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

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

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

[System.Security.SecurityCritical]
public bool Remove(System.DirectoryServices.AccountManagement.UserPrincipal user);

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

[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Remove (user As UserPrincipal) As Boolean

Параметры

user: UserPrincipal

Объект UserPrincipal.

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

Boolean

trueЗначение , UserPrincipalесли он PrincipalCollection был членом этогоfalse; в противном случае .

Атрибуты: SecurityCriticalAttribute

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

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

Remove(PrincipalContext, IdentityType, String)

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

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

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

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

UserPrincipal Находит объект, указанный заданной PrincipalContextidentityType/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);

[System.Security.SecurityCritical]
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

[<System.Security.SecurityCritical>]
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; в противном случае .

Атрибуты: SecurityCriticalAttribute

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

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

Обратная связь

Были ли сведения на этой странице полезными?

PrincipalCollection.Remove Метод

Определение

Перегрузки

Комментарии

Remove(ComputerPrincipal)

Параметры

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

Комментарии

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

Remove(GroupPrincipal)

Параметры

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

Комментарии

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

Remove(Principal)

Параметры

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

Реализации

Комментарии

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

Remove(UserPrincipal)

Параметры

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

Комментарии

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

Remove(PrincipalContext, IdentityType, String)

Параметры

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

Комментарии

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