Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Enumerable.Contains<TSource>(IEnumerable<TSource>, TSource, IEqualityComparer<TSource>)

 

Publicado: octubre de 2016

Determina si una secuencia contiene un elemento especificado mediante el uso de un objeto IEqualityComparer<T>.

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static bool Contains<TSource>(
	this IEnumerable<TSource> source,
	TSource value,
	IEqualityComparer<TSource> comparer
)

Parámetros

source
Type: System.Collections.Generic.IEnumerable<TSource>

Secuencia en la que se va a buscar un valor.

value
Type: TSource

Valor que se va a buscar en la secuencia.

comparer
Type: System.Collections.Generic.IEqualityComparer<TSource>

Comparador de igualdad que va a comparar los valores.

Valor devuelto

Type: System.Boolean

true Si la secuencia de origen contiene un elemento que tiene el valor especificado; de lo contrario, false.

Parámetros de tipo

TSource

Tipo de los elementos de source.

Exception Condition
ArgumentNullException

El valor de source es null.

La enumeración finaliza en cuanto se encuentra un elemento coincidente.

Si comparer es null, el comparador de igualdad predeterminado, Default, se utiliza para comparar los elementos con el valor especificado.

En el ejemplo siguiente se muestra cómo implementar un comparador de igualdad que se puede usar en la Contains<TSource> (método).

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

}

Después de implementar este comparador, puede utilizar una secuencia de Product objetos en el Contains<TSource> método, tal como se muestra en el ejemplo siguiente.


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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: