Enumerable.Contains Metoda

Reference

Definice

Obor názvů:: System.Linq

Sestavení:: System.Linq.dll

Sestavení:: System.Core.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Určuje, zda sekvence obsahuje zadaný prvek.

Přetížení

Contains<TSource>(IEnumerable<TSource>, TSource)	Určuje, zda sekvence obsahuje zadaný prvek pomocí výchozího porovnávače rovnosti.
Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)	Určuje, zda sekvence obsahuje zadaný prvek pomocí zadané IEqualityComparer<T>.

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

Zdroj:: Contains.cs

Zdroj:: Contains.cs

Zdroj:: Contains.cs

Určuje, zda sekvence obsahuje zadaný prvek pomocí výchozího porovnávače rovnosti.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Contains(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource value);

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

static member Contains : seq<'Source> * 'Source -> bool

<Extension()>
Public Function Contains(Of TSource) (source As IEnumerable(Of TSource), value As TSource) As Boolean

Parametry typu

TSource

Typ elementů .source

Parametry

source: IEnumerable<TSource>

Sekvence, ve které se má najít hodnota.

value: TSource

Hodnota, která se má najít v sekvenci.

Návraty

Boolean

truepokud zdrojová sekvence obsahuje prvek, který má zadanou hodnotu; v opačném případě . false

Výjimky

ArgumentNullException

source je null.

Příklady

Následující příklad kódu ukazuje, jak zjistit Contains<TSource>(IEnumerable<TSource>, TSource) , zda pole obsahuje určitý prvek.

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'.

' Create an array of strings.
Dim fruits() As String = {"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' This is the string to search the array for.
Dim fruit As String = "mango"

' Determine if the array contains the specified string.
Dim hasMango As Boolean = fruits.Contains(fruit)

Dim text As String = IIf(hasMango, "does", "does not")

' Display the output.
Console.WriteLine($"The array {text} contain {fruit}")

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

Poznámky

Pokud typ source implementuje ICollection<T>, Contains je vyvolána metoda v této implementaci k získání výsledku. V opačném případě tato metoda určuje, zda source obsahuje zadaný prvek.

Výčet je ukončen, jakmile je nalezen odpovídající prvek.

Elementy se porovnávají se zadanou hodnotou pomocí výchozího porovnávače rovnosti , Default.

Platí pro

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

Zdroj:: Contains.cs

Zdroj:: Contains.cs

Zdroj:: Contains.cs

Určuje, zda sekvence obsahuje zadaný prvek pomocí zadané IEqualityComparer<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Contains(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource value, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);

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

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

static member Contains : seq<'Source> * 'Source * System.Collections.Generic.IEqualityComparer<'Source> -> bool

<Extension()>
Public Function Contains(Of TSource) (source As IEnumerable(Of TSource), value As TSource, comparer As IEqualityComparer(Of TSource)) As Boolean

Parametry typu

TSource

Typ elementů .source

Parametry

source: IEnumerable<TSource>

Sekvence, ve které se má najít hodnota.

value: TSource

Hodnota, která se má najít v sekvenci.

comparer: IEqualityComparer<TSource>

Porovnávače rovnosti pro porovnávání hodnot.

Návraty

Boolean

truepokud zdrojová sekvence obsahuje prvek, který má zadanou hodnotu; v opačném případě . false

Výjimky

ArgumentNullException

source je null.

Příklady

Následující příklad ukazuje, jak implementovat porovnávací nástroj rovnosti, který lze použít v Contains metodě.

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;
    }
}

Public Class Product
    Public Property Name As String
    Public Property Code As Integer
End Class

' Custom comparer for the Product class
Public Class ProductComparer
    Implements IEqualityComparer(Of Product)

    Public Function Equals1(
        ByVal x As Product, 
        ByVal y As Product
        ) As Boolean Implements IEqualityComparer(Of Product).Equals

        ' Check whether the compared objects reference the same data.
        If x Is y Then Return True

        'Check whether any of the compared objects is null.
        If x Is Nothing OrElse y Is Nothing Then Return False

        ' Check whether the products' properties are equal.
        Return (x.Code = y.Code) AndAlso (x.Name = y.Name)
    End Function

    Public Function GetHashCode1(
        ByVal product As Product
        ) As Integer Implements IEqualityComparer(Of Product).GetHashCode

        ' Check whether the object is null.
        If product Is Nothing Then Return 0

        ' Get hash code for the Name field if it is not null.
        Dim hashProductName = 
            If(product.Name Is Nothing, 0, product.Name.GetHashCode())

        ' Get hash code for the Code field.
        Dim hashProductCode = product.Code.GetHashCode()

        ' Calculate the hash code for the product.
        Return hashProductName Xor hashProductCode
    End Function
End Class

Po implementaci tohoto porovnávače můžete v metodě použít posloupnost Product objektů Contains , jak je znázorněno v následujícím příkladu:

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


Dim fruits() As Product = 
   {New Product With {.Name = "apple", .Code = 9}, 
    New Product With {.Name = "orange", .Code = 4}, 
    New Product With {.Name = "lemon", .Code = 12}}

Dim apple = New Product With {.Name = "apple", .Code = 9}
Dim kiwi = New Product With {.Name = "kiwi", .Code = 8}

Dim prodc As New ProductComparer()

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

Console.WriteLine("Apple? " & hasApple)
Console.WriteLine("Kiwi? " & hasKiwi)


' This code produces the following output:
'
' Apple? True
' Kiwi? False

Poznámky

Výčet je ukončen, jakmile je nalezen odpovídající prvek.

Pokud comparer je null, použije se k porovnání elementů se zadanou hodnotou výchozí porovnávače Defaultrovnosti.

Platí pro

Sdílet prostřednictvím

Enumerable.Contains Metoda

Definice

Přetížení

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

Parametry typu

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry typu

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Další materiály