Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

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

 

Remove a primeira ocorrência de um objeto específico do Collection<T>.

Namespace:   System.Collections.ObjectModel
Assembly:  mscorlib (em mscorlib.dll)

public bool Remove(
	T item
)

Parâmetros

item
Type: T

O objeto a remover do Collection<T>. O valor pode ser null para tipos de referência.

Valor Retornado

Type: System.Boolean

true se item for removido com êxito; caso contrário, false. Esse método também retornará false se item não tiver sido encontrado no Collection<T> original.

This method determines equality using the default equality comparer P:System.Collections.Generic.EqualityComparer`1.Default for T, the type of values in the list.

This method performs a linear search; therefore, the average execution time is proportional to P:System.Collections.ObjectModel.Collection`1.Count. That is, this method is an O(n) operation, where n is P:System.Collections.ObjectModel.Collection`1.Count.

Observações para os Herdeiros:

Derived classes can override M:System.Collections.ObjectModel.Collection`1.RemoveItem(System.Int32) to change the behavior of this method.

The following code example demonstrates many of the properties and methods of T:System.Collections.ObjectModel.Collection`1. The code example creates a collection of strings, uses the M:System.Collections.ObjectModel.Collection`1.Add(`0) method to add several strings, displays the P:System.Collections.ObjectModel.Collection`1.Count, and lists the strings. The example uses the M:System.Collections.ObjectModel.Collection`1.IndexOf(`0) method to find the index of a string and the M:System.Collections.ObjectModel.Collection`1.Contains(`0) method to determine whether a string is in the collection. The example inserts a string using the M:System.Collections.ObjectModel.Collection`1.Insert(System.Int32,`0) method and retrieves and sets strings using the default P:System.Collections.ObjectModel.Collection`1.Item(System.Int32) property (the indexer in C#). The example removes strings by string identity using the M:System.Collections.ObjectModel.Collection`1.Remove(`0) method and by index using the M:System.Collections.ObjectModel.Collection`1.RemoveAt(System.Int32) method. Finally, the M:System.Collections.ObjectModel.Collection`1.Clear method is used to clear all strings from the collection.

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 do Windows
Disponível desde 8
.NET Framework
Disponível desde 2.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: