PropertyValueCollection.Remove(Object) Método

Definição

Espaço de Nomes:
System.DirectoryServices
Assemblagem:
System.DirectoryServices.dll

Remove um valor de propriedade especificado desta coleção.

public:
 void Remove(System::Object ^ value);
public void Remove(object value);
member this.Remove : obj -> unit
Public Sub Remove (value As Object)

Parâmetros

value
Object

O valor da propriedade a remover.

Exceções

ArgumentNullException

O valor da propriedade é uma referência nula (Nothing em Visual Basic).

COMException

Ocorreu um erro durante a chamada para a interface subjacente.

Exemplos

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

Observações

Ao trabalhar com um valor de propriedade de cadeia multivalorado, o Remove método remove com sucesso o item correto. No entanto, identificar os itens corretos pelo nome é difícil com um valor de propriedade DNWithString multi-valor (pois a classe DNWithString COM, usada para armazenar os itens DNWithString, tem 2 propriedades de cadeia que representam o item). A forma de remover esses itens é encontrar o objeto na coleção (percorrendo todos os itens) e depois chamar a Remove função com o ponteiro do objeto que acabaste de encontrar. Isto é ilustrado no exemplo abaixo.

Aplica-se a