PropertyValueCollection.Remove(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.