C# ContainsValue(Object)：确定集合是否包含具有指定值的元素

C# ContainsValue(Object)方法详解

1. 方法介绍

ContainsValue()方法是C#中Dictionary集合类的一个方法，用于判断字典中是否包含指定的值。

语法结构如下所示：

public bool ContainsValue(TValue value);

2. 参数说明

• value：要在字典中查找的值。

3. 返回值

如果字典中包含指定值，则返回true；否则返回false。

4. 调用示例

示例1：

以下示例展示了如何使用ContainsValue()方法查找字典中的值。

using System;
using System.Collections.Generic;

class Program
{
    static void Main(string[] args)
    {
        Dictionary<string, int> dic = new Dictionary<string, int>();
        dic.Add("one", 1);
        dic.Add("two", 2);
        dic.Add("three", 3);

        bool hasValue1 = dic.ContainsValue(1);  // True
        bool hasValue2 = dic.ContainsValue(4);  // False

        Console.WriteLine($"字典中是否包含值1：{hasValue1}");
        Console.WriteLine($"字典中是否包含值4：{hasValue2}");
    }
}

输出结果：

字典中是否包含值1：True
字典中是否包含值4：False

在上述代码中，创建了一个键值对类型为string和int的字典，其中添加了三个元素。然后分别使用ContainsValue()方法判断字典中是否包含值1和4。在结果中可以看到，只有字典中包含值1时，结果为True，而包含值4时结果为False。

示例2：

下面的示例演示了如何使用ContainsValue()方法判断字典中是否包含一个特定的自定义类型值。假设我们有一个自定义类Person，其中包含了Name和Age两个属性。

using System;
using System.Collections.Generic;

class Program
{
    static void Main(string[] args)
    {
        Dictionary<string, Person> dic = new Dictionary<string, Person>();
        dic.Add("xiaoming", new Person("小明", 18));
        dic.Add("xiaohong", new Person("小红", 20));
        dic.Add("xiaozhang", new Person("小张", 22));

        Person person1 = new Person("小红", 20);
        bool hasValue1 = dic.ContainsValue(person1);  // True

        Person person2 = new Person("小李", 24);
        bool hasValue2 = dic.ContainsValue(person2);  // False

        Console.WriteLine($"字典中是否包含年龄为20的{person1.Name}：{hasValue1}");
        Console.WriteLine($"字典中是否包含年龄为24的{person2.Name}：{hasValue2}");
    }
}

class Person
{
    public string Name { get; }
    public int Age { get; }

    public Person(string name, int age)
    {
        Name = name;
        Age = age;
    }
}

示例中首先定义了一个Dictionary类型的字典，然后分别向字典中添加了三个元素。最后分别使用ContainsValue()方法判断字典中是否包含年龄为20的小红和年龄为24的小李。在输出结果中，可以看到对于第一个判断结果为True，对于第二个判断结果为False。

5. 总结

ContainsValue()方法是一个用于在C#中Dictionary集合类中查找指定值得方法。使用这个方法，可以快速地查找字典中是否包含了指定的值。在使用这个方法时需要注意，当字典中存在多个值时，这个方法只返回第一个查找到的值。