PropertyValueCollection.Remove(Object) Metoda

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v11.0.0-preview.5.26302.115

Zdroj:

PropertyValueCollection.cs

Odebere zadanou hodnotu vlastnosti z této kolekce.

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, kterou chcete odebrat.

Výjimky

ArgumentNullException

Hodnota vlastnosti je odkaz null (Nothing v 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á s hodnotou vlastnosti DNWithString s více hodnotami (jako DNWithString COM třída, která se používá k ukládání položek DNWithString, má 2 řetězcové vlastnosti představující položku). Způsob, jak takové položky odebrat, je najít objekt v kolekci (smyčkou přes všechny položky) a pak volat Remove funkci ukazatelem objektu, který jste právě našli. To je znázorněno v následujícím příkladu.