List<T>.RemoveAll(Predicate<T>) 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

List.cs

移除符合指定的述詞所定義之條件的所有項目。

C#

public int RemoveAll (Predicate<T> match);

參數

match

Predicate<T>

Predicate<T> 委派，定義要移除項目的條件。

傳回

Int32

從 List<T> 移除的項目數。

例外狀況

ArgumentNullException

match 為 null。

範例

下列範例示範 RemoveAll 方法，以及使用 Predicate<T> 泛型委派的數個其他方法。

建立字串的 ，其中包含8個 List<T> 恐龍名稱，其中兩個 (位置1和5) 結尾為 “saurus”。 此範例也會定義名為 EndsWithSaurus的搜尋述詞方法，此方法會接受字串參數，並傳回布爾值，指出輸入字串是否以 「saurus」 結尾。

Find、 FindLast和 FindAll 方法可用來使用搜尋述詞方法來搜尋清單。

方法 RemoveAll 用來移除以 「saurus」 結尾的所有專案。 它會從開頭周遊清單，並將每個元素逐一傳遞至 EndsWithSaurus 方法。 如果方法傳true回 ，則會EndsWithSaurus移除 專案。

備註

在 C# 和 Visual Basic 中，不需要在 Visual Basic 中明確建立 Predicate<string> 委派 (Predicate(Of String)) 。 這些語言會從內容推斷正確的委派，並自動建立它。

最後， Exists 方法會驗證清單中沒有以 「saurus」 結尾的字串。

C#

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Oviraptor");
        dinosaurs.Add("Velociraptor");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Dilophosaurus");
        dinosaurs.Add("Gallimimus");
        dinosaurs.Add("Triceratops");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nTrueForAll(EndsWithSaurus): {0}",
            dinosaurs.TrueForAll(EndsWithSaurus));

        Console.WriteLine("\nFind(EndsWithSaurus): {0}",
            dinosaurs.Find(EndsWithSaurus));

        Console.WriteLine("\nFindLast(EndsWithSaurus): {0}",
            dinosaurs.FindLast(EndsWithSaurus));

        Console.WriteLine("\nFindAll(EndsWithSaurus):");
        List<string> sublist = dinosaurs.FindAll(EndsWithSaurus);

        foreach(string dinosaur in sublist)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine(
            "\n{0} elements removed by RemoveAll(EndsWithSaurus).",
            dinosaurs.RemoveAll(EndsWithSaurus));

        Console.WriteLine("\nList now contains:");
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nExists(EndsWithSaurus): {0}",
            dinosaurs.Exists(EndsWithSaurus));
    }

    // Search predicate returns true if a string ends in "saurus".
    private static bool EndsWithSaurus(String s)
    {
        return s.ToLower().EndsWith("saurus");
    }
}

/* This code example produces the following output:

Compsognathus
Amargasaurus
Oviraptor
Velociraptor
Deinonychus
Dilophosaurus
Gallimimus
Triceratops

TrueForAll(EndsWithSaurus): False

Find(EndsWithSaurus): Amargasaurus

FindLast(EndsWithSaurus): Dilophosaurus

FindAll(EndsWithSaurus):
Amargasaurus
Dilophosaurus

2 elements removed by RemoveAll(EndsWithSaurus).

List now contains:
Compsognathus
Oviraptor
Velociraptor
Deinonychus
Gallimimus
Triceratops

Exists(EndsWithSaurus): False
 */

備註

Predicate<T>是方法的委派，如果傳遞給它的物件符合委派中定義的條件，則會傳回 true 。 目前 List<T> 的專案會個別傳遞至 Predicate<T> 委派，而符合條件的專案則會從 List<T>中移除。

這個方法會執行線性搜尋;因此，這個方法是 o (n) 運算，其中 n 是 Count。

適用於

另請參閱

• FindAll(Predicate<T>)
• Predicate<T>
• Remove(T)
• RemoveAt(Int32)
• RemoveRange(Int32, Int32)