PropertyValueCollection.Remove(Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita un valor de propiedad especificado de la colección.
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)Parámetros
- value
- Object
Valor de propiedad que se va a quitar.
Excepciones
El valor de propiedad es una referencia nula (Nothing en Visual Basic).
Se produjo un error durante la llamada a la interfaz subyacente.
Ejemplos
// 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();
Comentarios
Al trabajar con un valor de propiedad de cadena con varios valores, el Remove método quitará correctamente el elemento correcto. Sin embargo, identificar los elementos correctos por nombre es difícil con un valor de propiedad DNWithString multivalor (como la clase COM DNWithString, que se usa para almacenar los elementos DNWithString, tiene dos propiedades de cadena que representan el elemento). La manera de quitar estos elementos es buscar el objeto en la colección (haciendo un bucle de todos los elementos) y, a continuación, llamar a la Remove función con el puntero del objeto que acaba de encontrar. Esto se muestra en el ejemplo siguiente.
