PropertyValueCollection.Remove(Object) Метод

Определение

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

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Пакет:

System.DirectoryServices v8.0.0

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

PropertyValueCollection.cs

Удаляет указанное значение свойства из этой коллекции.

public:
 void Remove(System::Object ^ value);

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Параметры

value

Object

Значение свойства, которое нужно удалить.

Исключения

ArgumentNullException

Значение свойства является пустой ссылкой (Nothing в Visual Basic).

COMException

Произошла ошибка при вызове базового интерфейса.

Примеры

// Bind to the AD object  
DirectoryEntry myUser = new DirectoryEntry("LDAP://AdServer:389/CN=MyUsername,CN=Users,DC=contoso,DC=com");  

// Get the attribute  
PropertyValueCollection testAttribute = myUser.Properties["someAttribute"];  

// Find the item in the collection that we want to delete  
DNWithString dnwsItemToRemove = null;  
foreach (DNWithString dnwsItem in testAttribute)  
{  
    if (dnwsItem.StringValue.Equals("SomeValue"))  
    {  
        dnwsItemToRemove = dnwsItem;  
        break;  
    }  
}  

// Delete it  
testAttribute.Remove(dnwsItemToRemove);  

// Store the data  
myUser.CommitChanges();  

Комментарии

При работе с многозначным значением Remove строкового свойства метод успешно удалит правильный элемент. Однако определить правильные элементы по имени сложно с помощью многозначного значения свойства DNWithString (так как com-класс DNWithString, используемый для хранения элементов DNWithString, имеет 2 строковых свойства, представляющих элемент). Способ удаления таких элементов — найти объект в коллекции (зациклив все элементы), а затем вызвать функцию Remove с указателем объекта, который вы только что нашли. Это показано в приведенном ниже примере.