PropertyValueCollection.Remove(Object) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Entfernt einen angegebenen Eigenschaftswert aus dieser Sammlung.

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

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, wird die Remove Methode das richtige Element erfolgreich entfernen. Die Identifizierung der richtigen Elemente nach Name ist jedoch mit einem wertigen DNWithString-Eigenschaftswert schwierig (wie die DNWithString COM-Klasse, die zum Speichern der DNWithString-Elemente verwendet wird, verfügt über 2 Zeichenfolgeneigenschaften, die das Element darstellen). Die Möglichkeit, solche Elemente zu entfernen, besteht darin, das Objekt in der Auflistung zu finden (indem Sie alle Elemente durchlaufen), und rufen Remove Sie dann die Funktion mit dem Zeiger des Objekts auf, den Sie gerade gefunden haben. Dies wird im folgenden Beispiel veranschaulicht.