Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Collection<T>.Remove (T)

 

Publicado: octubre de 2016

Quita la primera aparición de un objeto específico de la interfaz Collection<T>.

Espacio de nombres:   System.Collections.ObjectModel
Ensamblado:  mscorlib (en mscorlib.dll)

public bool Remove(
	T item
)

Parámetros

item
Type: T

Objeto que se va a quitar de Collection<T>. El valor puede ser null para los tipos de referencia.

Valor devuelto

Type: System.Boolean

Es true si item se quita correctamente; en caso contrario, es false. Este método también devuelve false si no se encontró item en el Collection<T> original.

Este método determina la igualdad utilizando el comparador de igualdad predeterminado EqualityComparer<T>.Default para T, el tipo de valores de la lista.

Este método realiza una búsqueda lineal; por lo tanto, el tiempo medio de ejecución es proporcional al Count. Es decir, este método es una O (n) operación, donde n es Count.

Notas para desarrolladores de herederos:

Las clases derivadas pueden reemplazar RemoveItem para cambiar el comportamiento de este método.

En el ejemplo de código siguiente se muestra muchas de las propiedades y métodos de Collection<T>. El ejemplo de código crea una colección de cadenas, utiliza el Add para agregar varias cadenas, se muestra el Count, y enumera las cadenas. El ejemplo utiliza el IndexOf método para encontrar el índice de una cadena y la Contains método para determinar si una cadena está en la colección. En el ejemplo se inserta una cadena mediante el Insert (método) y recupera y conjuntos de cadenas utilizando el valor predeterminado Item propiedad (el indizador en C#). Quitan cadenas mediante el uso de la identidad en la cadena el Remove método e índice utilizando la RemoveAt (método). Por último, el Clear método se utiliza para borrar todas las cadenas de la colección.

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Demo
{
    public static void Main()
    {
        Collection<string> dinosaurs = new Collection<string>();

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

        Console.WriteLine("{0} dinosaurs:", dinosaurs.Count);
        Display(dinosaurs);

        Console.WriteLine("\nIndexOf(\"Muttaburrasaurus\"): {0}", 
            dinosaurs.IndexOf("Muttaburrasaurus"));

        Console.WriteLine("\nContains(\"Caudipteryx\"): {0}", 
            dinosaurs.Contains("Caudipteryx"));

        Console.WriteLine("\nInsert(2, \"Nanotyrannus\")");
        dinosaurs.Insert(2, "Nanotyrannus");
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs[2]: {0}", dinosaurs[2]);

        Console.WriteLine("\ndinosaurs[2] = \"Microraptor\"");
        dinosaurs[2] = "Microraptor";
        Display(dinosaurs);

        Console.WriteLine("\nRemove(\"Microraptor\")");
        dinosaurs.Remove("Microraptor");
        Display(dinosaurs);

        Console.WriteLine("\nRemoveAt(0)");
        dinosaurs.RemoveAt(0);
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs.Clear()");
        dinosaurs.Clear();
        Console.WriteLine("Count: {0}", dinosaurs.Count);
    }

    private static void Display(Collection<string> cs)
    {
        Console.WriteLine();
        foreach( string item in cs )
        {
            Console.WriteLine(item);
        }
    }
}

/* This code example produces the following output:

4 dinosaurs:

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")

Psitticosaurus
Caudipteryx
Nanotyrannus
Compsognathus
Muttaburrasaurus

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"

Psitticosaurus
Caudipteryx
Microraptor
Compsognathus
Muttaburrasaurus

Remove("Microraptor")

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

RemoveAt(0)

Caudipteryx
Compsognathus
Muttaburrasaurus

dinosaurs.Clear()
Count: 0
 */

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: