PropertyValueCollection.Remove(Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u een opgegeven eigenschapswaarde uit deze verzameling.
public:
void Remove(System::Object ^ value);public void Remove(object? value);public void Remove(object value);member this.Remove : obj -> unitPublic Sub Remove (value As Object)Parameters
- value
- Object
De eigenschapswaarde die u wilt verwijderen.
Uitzonderingen
De eigenschapswaarde is een null-verwijzing (Nothing in Visual Basic).
Er is een fout opgetreden tijdens het aanroepen van de onderliggende interface.
Voorbeelden
// 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();
Opmerkingen
Wanneer u met een eigenschapswaarde met meerdere waarden werkt, wordt het juiste item verwijderd door de Remove methode. Het identificeren van de juiste items op naam is echter moeilijk met een DNWithString-eigenschapswaarde met meerdere waarden (als de DNWithString COM-klasse, die wordt gebruikt om de DNWithString-items op te slaan, heeft twee tekenreekseigenschappen die het item vertegenwoordigen). De manier om dergelijke items te verwijderen, is door het object in de verzameling te zoeken (door alle items te herhalen), en vervolgens de Remove functie aan te roepen met de aanwijzer van het object dat u zojuist hebt gevonden. Dit wordt geïllustreerd in het onderstaande voorbeeld.
