PropertyValueCollection.Remove(Object) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

PropertyValueCollection.cs

Entfernt einen angegebenen Eigenschaftswert aus dieser Sammlung.

public:
 void Remove(System::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

ArgumentNullException

Der Eigenschaftswert ist ein NULL-Verweis (Nothing in Visual Basic).

COMException

Während des Aufrufs der zugrunde liegenden Schnittstelle ist ein Fehler aufgetreten.

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

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