PropertyValueCollection.Remove(Object) Método

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

PropertyValueCollection.cs

Remove um valor da 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 ser removido.

Exceções

ArgumentNullException

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

COMException

Erro durante a chamada à 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();  

Comentários

Ao trabalhar com um valor de propriedade de cadeia de caracteres de vários valores, o Remove método removerá com êxito o item correto. No entanto, identificar os itens corretos por nome é difícil com um valor de propriedade DNWithString de vários valores (como a classe COM DNWithString, que é usada para armazenar os itens DNWithString, tem duas propriedades de cadeia de caracteres que representam o item). A maneira de remover esses itens é localizar o objeto na coleção (fazendo loop por meio de todos os itens) e, em seguida, chamar a Remove função com o ponteiro do objeto que você acabou de encontrar. Isso é ilustrado no exemplo abaixo.