PropertyValueCollection.Remove(Object) Methode

Definition

Entfernt einen angegebenen Eigenschaftswert aus dieser Auflistung.

public:
 void Remove(System::Object ^ value);
public void Remove(object? value);
public void Remove(object value);
member this.Remove : obj -> unit
Public Sub Remove (value As Object)

Parameter

value
Object

Der zu entfernende Eigenschaftswert.

Ausnahmen

Der Eigenschaftswert ist ein Nullverweis (Nothing in Visual Basic).

Fehler beim Aufruf der zugrunde liegenden Schnittstelle.

Beispiele

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

Hinweise

Beim Arbeiten mit einem mehrwertigen Zeichenfolgeneigenschaftswert wird das richtige Element von der Remove Methode erfolgreich entfernt. Das Identifizieren der richtigen Elemente anhand des Namens ist jedoch mit einem mehrwertigen DNWithString-Eigenschaftswert schwierig (da die DNWithString COM-Klasse, die zum Speichern der DNWithString-Elemente verwendet wird, 2 Zeichenfolgeneigenschaften, die das Element darstellen). Die Möglichkeit zum Entfernen solcher Elemente besteht darin, das Objekt in der Auflistung zu finden (durch Schleifendurchlauf durch alle Elemente), und rufen Sie dann die Remove Funktion mit dem soeben gefundenen Zeiger des Objekts auf. Dies wird im folgenden Beispiel veranschaulicht.

Gilt für: