List<T>.ForEach(Action<T>) Método

Definição

Namespace:: System.Collections.Generic

Assembly:: System.Collections.dll

Assemblies:: mscorlib.dll, System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Executa a ação especificada em cada elemento do List<T>.Performs the specified action on each element of the List<T>.

public:
 void ForEach(Action<T> ^ action);

public void ForEach (Action<T> action);

member this.ForEach : Action<'T> -> unit

Public Sub ForEach (action As Action(Of T))

Parâmetros

action: Action<T>

O delegado Action<T> a ser executado em cada elemento do List<T>.The Action<T> delegate to perform on each element of the List<T>.

Exceções

ArgumentNullException

action é null.action is null.

InvalidOperationException

Um elemento na coleção foi modificado.An element in the collection has been modified.

Exemplos

O exemplo a seguir demonstra o uso do Action<T> delegado para imprimir o conteúdo de um List<T> objeto.The following example demonstrates the use of the Action<T> delegate to print the contents of a List<T> object. Neste exemplo, o Print método é usado para exibir o conteúdo da lista para o console.In this example the Print method is used to display the contents of the list to the console.

Observação

Além de exibir o conteúdo usando o Print método, o exemplo C# demonstra o uso de métodos anônimos para exibir os resultados para o console.In addition to displaying the contents using the Print method, the C# example demonstrates the use of anonymous methods to display the results to the console.

List<String> names = new List<String>();
names.Add("Bruce");
names.Add("Alfred");
names.Add("Tim");
names.Add("Richard");

// Display the contents of the list using the Print method.
names.ForEach(Print);

// The following demonstrates the anonymous method feature of C#
// to display the contents of the list to the console.
names.ForEach(delegate(String name)
{
    Console.WriteLine(name);
});

void Print(string s)
{
    Console.WriteLine(s);
}

/* This code will produce output similar to the following:
* Bruce
* Alfred
* Tim
* Richard
* Bruce
* Alfred
* Tim
* Richard
*/

Imports System.Collections.Generic

Class Program
    Shared Sub Main()
        Dim names As New List(Of String)
        names.Add("Bruce")
        names.Add("Alfred")
        names.Add("Tim")
        names.Add("Richard")

        ' Display the contents of the list using the Print method.
        names.ForEach(AddressOf Print)
    End Sub

    Shared Sub Print(ByVal s As String)
        Console.WriteLine(s)
    End Sub
End Class

' This code will produce output similar to the following:
' Bruce
' Alfred
' Tim
' Richard

Comentários

O Action<T> é um delegado a um método que executa uma ação no objeto passado para ele.The Action<T> is a delegate to a method that performs an action on the object passed to it. Os elementos da atual List<T> são passados individualmente para o Action<T> delegado.The elements of the current List<T> are individually passed to the Action<T> delegate.

Esse método é uma operação O (n), onde n é Count .This method is an O(n) operation, where n is Count.

Não há suporte para modificar a coleção subjacente no corpo do Action<T> delegado e causa um comportamento indefinido.Modifying the underlying collection in the body of the Action<T> delegate is not supported and causes undefined behavior.

Aplica-se a

Confira também

Action<T>