PropertyValueCollection.Remove(Object) Metoda

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

PropertyValueCollection.cs

Odebere z této kolekce zadanou hodnotu vlastnosti.

public:
 void Remove(System::Object ^ value);

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parametry

value

Object

Hodnota vlastnosti, která se má odebrat.

Výjimky

ArgumentNullException

Hodnota vlastnosti je odkaz null (Nothing v jazyce Visual Basic).

COMException

Během volání základního rozhraní došlo k chybě.

Příklady

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

Poznámky

Při práci s hodnotou Remove vlastnosti řetězce s více hodnotami metoda úspěšně odebere správnou položku. Identifikace správných položek podle názvu je však obtížná u hodnoty vlastnosti DNWithString s více hodnotami (protože třída MODELU COM DNWithString, která se používá k ukládání položek DNWithString, má 2 vlastnosti řetězce představující položku). Způsob, jak tyto položky odebrat, je najít objekt v kolekci (pomocí smyčky mezi všemi položkami) a pak zavolat Remove funkci s ukazatelem objektu, který jste právě našli. To je znázorněno v následujícím příkladu.