Enumerable.Contains Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Bestimmt, ob eine Sequenz ein angegebenes Element enthält.

Überlädt

Contains<TSource>(IEnumerable<TSource>, TSource)	Bestimmt mithilfe des Standardgleichheitsvergleichs, ob eine Sequenz ein angegebenes Element enthält
Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)	Bestimmt mithilfe eines angegebenen IEqualityComparer<T>, ob eine Sequenz ein angegebenes Element enthält

Contains<TSource>(IEnumerable<TSource>, TSource)

Quelle:

Contains.cs

Bestimmt mithilfe des Standardgleichheitsvergleichs, ob eine Sequenz ein angegebenes Element enthält

C#

public static bool Contains<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource value);

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Eine Sequenz, in der ein Wert gesucht werden soll.

value

TSource

Der Wert, der in der Sequenz gesucht werden soll.

Gibt zurück

Boolean

true, wenn die Quellsequenz ein Element mit dem angegebenen Wert enthält, andernfalls false.

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Contains<TSource>(IEnumerable<TSource>, TSource) , um zu bestimmen, ob ein Array ein bestimmtes Element enthält.

C#

string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

string fruit = "mango";

bool hasMango = fruits.Contains(fruit);

Console.WriteLine(
    "The array {0} contain '{1}'.",
    hasMango ? "does" : "does not",
    fruit);

// This code produces the following output:
//
// The array does contain 'mango'.

Hinweise

Wenn der Typ von source implementiert ICollection<T>ist, wird die -Methode in dieser Contains Implementierung aufgerufen, um das Ergebnis zu erhalten. Andernfalls bestimmt diese Methode, ob source das angegebene Element enthält.

Die Enumeration wird beendet, sobald ein übereinstimmende Element gefunden wird.

Elemente werden mit dem angegebenen Wert verglichen, indem der Standardmäßige Gleichheitsvergleich verwendet wird Default.

Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)

Quelle:

Contains.cs

Bestimmt mithilfe eines angegebenen IEqualityComparer<T>, ob eine Sequenz ein angegebenes Element enthält

C#

public static bool Contains<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource value, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Eine Sequenz, in der ein Wert gesucht werden soll.

value

TSource

Der Wert, der in der Sequenz gesucht werden soll.

comparer

IEqualityComparer<TSource>

Ein Gleichheitsvergleich zum Vergleichen von Werten.

Gibt zurück

Boolean

true, wenn die Quellsequenz ein Element mit dem angegebenen Wert enthält, andernfalls false.

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Gleichheitsvergleich implementieren, der in der Contains -Methode verwendet werden kann.

C#

public class Product
{
    public string Name { get; set; }
    public int Code { get; set; }
}

// Custom comparer for the Product class
class ProductComparer : IEqualityComparer<Product>
{
    // Products are equal if their names and product numbers are equal.
    public bool Equals(Product x, Product y)
    {

        //Check whether the compared objects reference the same data.
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether any of the compared objects is null.
        if (Object.ReferenceEquals(x, null) || Object.ReferenceEquals(y, null))
            return false;

        //Check whether the products' properties are equal.
        return x.Code == y.Code && x.Name == y.Name;
    }

    // If Equals() returns true for a pair of objects
    // then GetHashCode() must return the same value for these objects.

    public int GetHashCode(Product product)
    {
        //Check whether the object is null
        if (Object.ReferenceEquals(product, null)) return 0;

        //Get hash code for the Name field if it is not null.
        int hashProductName = product.Name == null ? 0 : product.Name.GetHashCode();

        //Get hash code for the Code field.
        int hashProductCode = product.Code.GetHashCode();

        //Calculate the hash code for the product.
        return hashProductName ^ hashProductCode;
    }
}

Nachdem Sie diesen Vergleich implementiert haben, können Sie eine Sequenz von Product Objekten in der Contains -Methode verwenden, wie im folgenden Beispiel gezeigt:

C#

Product[] fruits = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "orange", Code = 4 },
                       new Product { Name = "lemon", Code = 12 } };

Product apple = new Product { Name = "apple", Code = 9 };
Product kiwi = new Product { Name = "kiwi", Code = 8 };

ProductComparer prodc = new ProductComparer();

bool hasApple = fruits.Contains(apple, prodc);
bool hasKiwi = fruits.Contains(kiwi, prodc);

Console.WriteLine("Apple? " + hasApple);
Console.WriteLine("Kiwi? " + hasKiwi);

/*
    This code produces the following output:

    Apple? True
    Kiwi? False
*/

Hinweise

Die Enumeration wird beendet, sobald ein übereinstimmende Element gefunden wird.

Wenn comparer ist null, wird der Standardmäßige Gleichheitsvergleich verwendet, Defaultum Elemente mit dem angegebenen Wert zu vergleichen.