이 설명서는 보관되지만 유지 되지 않습니다.

List.Exists 메서드

참고: 이 메서드는 .NET Framework 버전 2.0에서 새로 추가되었습니다.

지정된 조건자에 정의된 조건과 일치하는 요소가 List에 포함되어 있는지 여부를 확인합니다.

네임스페이스: System.Collections.Generic
어셈블리: mscorlib(mscorlib.dll)

public bool Exists (
	Predicate<T> match
)
public boolean Exists (
	Predicate<T> match
)
public function Exists (
	match : Predicate<T>
) : boolean

매개 변수

match

검색할 요소의 조건을 정의하는 Predicate 대리자입니다.

반환 값

지정된 조건자에 정의된 조건과 일치하는 요소가 하나 이상 List에 포함되어 있으면 true이고, 그렇지 않으면 false입니다.

예외 형식조건

ArgumentNullException

match가 Null 참조(Visual Basic의 경우 Nothing)인 경우

Predicate는 전달된 개체가 대리자에 정의된 조건과 일치하는 경우 true를 반환하는 메서드의 대리자입니다. 현재 List의 요소가 개별적으로 Predicate 대리자에 전달되고 일치가 발견되면 처리가 중지됩니다.

이 메서드는 선형 검색을 수행하기 때문에 O(n) 연산입니다. 여기서 nCount입니다.

다음 코드 예제에서는 Exists 메서드와 Predicate 제네릭 대리자를 사용하는 몇 가지 다른 메서드를 보여 줍니다.

문자열의 List이 만들어집니다. 여기에는 공룡 이름이 8개 포함되고 위치 1과 5에 있는 두 이름은 "saurus"로 끝납니다. 이 코드 예제에서는 EndsWithSaurus라는 검색 조건자 메서드도 정의합니다. 이 메서드는 문자열 매개 변수를 사용하고 입력 문자열이 "saurus"로 끝나는지 여부를 나타내는 부울 값을 반환합니다.

또한 Find, FindLastFindAll 메서드를 사용하여 검색 조건자 메서드로 목록을 검색한 다음 RemoveAll 메서드를 사용하여 "saurus"로 끝나는 엔트리를 모두 제거합니다.

마지막으로 Exists 메서드를 호출합니다. 이 메서드는 목록의 시작 부분부터 이동하면서 각 요소를 차례로 EndsWithSaurus 메서드에 전달합니다. EndsWithSaurus 메서드가 요소에 대해 true를 반환하면 검색이 중지되고 이 메서드는 true를 반환합니다. 해당 요소가 모두 제거되었기 때문에 Exists 메서드는 false를 반환합니다.

Note참고

C#과 Visual Basic에서는 Predicate<string> 대리자(Visual Basic의 경우 Predicate(Of String))를 명시적으로 만들 필요가 없습니다. 이러한 언어에서는 컨텍스트에서 올바른 대리자를 유추하여 자동으로 만듭니다.

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)
    {
        if ((s.Length > 5) && 
            (s.Substring(s.Length - 6).ToLower() == "saurus"))
        {
            return true;
        }
        else
        {
            return false;
        }
    }
}

/* 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
 */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

.NET Framework

2.0에서 지원

.NET Compact Framework

2.0에서 지원
표시: