PropertyValueCollection.Remove(Object) Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

Pakiet:

System.DirectoryServices v8.0.0

Źródło:

PropertyValueCollection.cs

Usuwa określoną wartość właściwości z tej kolekcji.

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

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parametry

value

Object

Wartość właściwości do usunięcia.

Wyjątki

ArgumentNullException

Wartość właściwości jest odwołaniem o wartości null (Nothing w Visual Basic).

COMException

Wystąpił błąd podczas wywołania podstawowego interfejsu.

Przykłady

// 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();  

Uwagi

Podczas pracy z wielowartośćową wartością Remove właściwości ciągu metoda pomyślnie usunie prawidłowy element. Jednak identyfikowanie poprawnych elementów według nazwy jest trudne z wielowartościową wartością właściwości DNWithString (jako klasa DNWithString COM, która jest używana do przechowywania elementów DNWithString, ma 2 właściwości ciągu reprezentujące element). Sposobem usunięcia takich elementów jest znalezienie obiektu w kolekcji (poprzez zapętlenie przez wszystkie elementy), a następnie wywołanie Remove funkcji za pomocą właśnie znalezionego wskaźnika obiektu. Jest to zilustrowane w poniższym przykładzie.