PropertyValueCollection.Remove(Object) Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices

Zestaw:

System.DirectoryServices.dll

Pakiet:

System.DirectoryServices v11.0.0-preview.7.26381.103

Ź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 interfejsu bazowego.

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 wartością właściwości ciągu wielowartego Remove metoda pomyślnie usunie prawidłowy element. Jednak zidentyfikowanie prawidłowych 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 (przez pętlę przez wszystkie elementy), a następnie wywołanie Remove funkcji za pomocą wskaźnika obiektu, który właśnie został znaleziony. Jest to pokazane w poniższym przykładzie.