C#的LINQ（语言集成查询）为集合操作提供了非常便捷的方法，其中Contains方法是实现集合包含判断的核心工具，能够直接模拟SQL语句中IN查询的逻辑，避免手动编写循环遍历的冗余代码。
LINQ Contains方法基础语法
Contains方法属于System.Linq命名空间下的扩展方法，主要用于判断某个元素是否存在于指定的集合中，返回值为布尔类型。基础语法格式如下：
// 引入LINQ命名空间 using System.Linq; // 集合对象.Contains(要判断的元素) bool result = collection.Contains(item);
需要注意的是，使用Contains方法前必须确保代码文件顶部引入了System.Linq命名空间，否则编译器会提示找不到该方法。
简单值类型集合的包含判断
对于int、string等简单值类型的集合，Contains方法的使用非常直接，和SQL的IN查询逻辑高度相似。
示例：判断数字是否在目标集合中
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
// 定义目标数字集合，类似SQL里的IN (1,3,5,7,9)
List<int> targetNumbers = new List<int> { 1, 3, 5, 7, 9 };
// 要判断的数字
int checkNumber = 5;
// 使用Contains判断是否存在
bool isExist = targetNumbers.Contains(checkNumber);
Console.WriteLine($"数字{checkNumber}是否存在于集合中：{isExist}"); // 输出：数字5是否存在于集合中：True
checkNumber = 2;
isExist = targetNumbers.Contains(checkNumber);
Console.WriteLine($"数字{checkNumber}是否存在于集合中：{isExist}"); // 输出：数字2是否存在于集合中：False
}
}
示例：字符串集合的包含判断
字符串类型的集合使用Contains时，默认区分大小写，如果需要忽略大小写，需要额外传入字符串比较规则。
using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
static void Main()
{
List<string> userRoles = new List<string> { "Admin", "Editor", "Viewer" };
string checkRole = "admin";
// 默认区分大小写，返回False
bool defaultResult = userRoles.Contains(checkRole);
Console.WriteLine($"默认判断结果：{defaultResult}");
// 忽略大小写判断，需要自定义比较器
bool ignoreCaseResult = userRoles.Contains(checkRole, StringComparer.OrdinalIgnoreCase);
Console.WriteLine($"忽略大小写判断结果：{ignoreCaseResult}"); // 输出：忽略大小写判断结果：True
}
}
复杂对象集合的包含判断
当集合元素是自定义类对象时，直接使用Contains方法默认会比较对象的引用地址，无法得到预期的结果，这时候需要重写类的Equals和GetHashCode方法，或者传入自定义的比较器。
示例：自定义对象集合的包含判断
using System;
using System.Collections.Generic;
using System.Linq;
// 定义用户类
public class User
{
public int Id { get; set; }
public string Name { get; set; }
// 重写Equals方法，根据Id判断两个对象是否相等
public override bool Equals(object obj)
{
if (obj == null || GetType() != obj.GetType())
return false;
User other = (User)obj;
return Id == other.Id;
}
// 重写GetHashCode，和Equals逻辑保持一致
public override int GetHashCode()
{
return Id.GetHashCode();
}
}
class Program
{
static void Main()
{
// 目标用户集合
List<User> userList = new List<User>
{
new User { Id = 1, Name = "张三" },
new User { Id = 2, Name = "李四" },
new User { Id = 3, Name = "王五" }
};
// 要检查的用户对象
User checkUser = new User { Id = 2, Name = "李四" };
// 使用Contains判断
bool isExist = userList.Contains(checkUser);
Console.WriteLine($"用户{checkUser.Name}是否存在于集合中：{isExist}"); // 输出：用户李四是否存在于集合中：True
}
}
模拟SQL IN查询的进阶用法
在实际开发中，经常会遇到需要根据一个集合的值，筛选另一个集合中符合条件的元素，这和SQL的WHERE 字段 IN (值1,值2)逻辑完全一致，可以结合Where方法和Contains方法实现。
using System;
using System.Collections.Generic;
using System.Linq;
public class Product
{
public int ProductId { get; set; }
public string ProductName { get; set; }
public decimal Price { get; set; }
}
class Program
{
static void Main()
{
// 所有产品集合
List<Product> allProducts = new List<Product>
{
new Product { ProductId = 1, ProductName = "手机", Price = 2999 },
new Product { ProductId = 2, ProductName = "电脑", Price = 5999 },
new Product { ProductId = 3, ProductName = "平板", Price = 3999 },
new Product { ProductId = 4, ProductName = "耳机", Price = 599 },
new Product { ProductId = 5, ProductName = "键盘", Price = 299 }
};
// 要筛选的产品ID集合，类似SQL的IN (1,3,5)
List<int> targetIds = new List<int> { 1, 3, 5 };
// 筛选出ID在targetIds中的产品
var filteredProducts = allProducts.Where(p => targetIds.Contains(p.ProductId)).ToList();
Console.WriteLine("筛选后的产品：");
foreach (var product in filteredProducts)
{
Console.WriteLine($"ID：{product.ProductId}，名称：{product.ProductName}，价格：{product.Price}");
}
// 输出：
// ID：1，名称：手机，价格：2999
// ID：3，名称：平板，价格：3999
// ID：5，名称：键盘，价格：299
}
}
注意事项
- Contains方法的判断逻辑依赖于元素的相等比较规则，值类型默认比较值，引用类型默认比较引用地址，复杂对象需要重写相等比较逻辑。
- 对于大型集合，Contains方法的查找效率取决于集合类型，List<T>的Contains是线性查找，HashSet<T>的Contains是哈希查找，效率更高，如果频繁做包含判断，建议优先使用HashSet<T>。
- 如果判断的元素为null，需要确保集合允许null值，否则可能会抛出空引用异常。
C#LINQ_Contains集合包含判断SQL_IN查询修改时间：2026-07-16 17:36:29