C#怎么使用Tuple和ValueTuple C#元组类型使用方法_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C#怎么使用Tuple和ValueTuple C#元组类型使用方法

2025-12-12

浏览次数：次

返回列表

推荐使用ValueTuple而非Tuple，因其是值类型、性能更优、支持命名字段和解构；声明简洁如("张三",28,true)，可命名如(Name:"王五",Age:25)，支持var(name,age)=t解构，.NET Core 2.0+原生支持。

c#怎么使用tuple和valuetuple c#元组类型使用方法

在C#中，Tuple（引用类型，.NET Framework 4.0引入）和ValueTuple（值类型，C# 7.0+推荐使用）都用于快速封装多个不同类型的值，但它们在性能、语法和用法上有明显区别。现在基本只推荐用 ValueTuple，它更轻量、支持解构、可命名字段，且无需额外 NuGet 包（.NET Core 2.0+ / .NET 5+ 内置）。

ValueTuple 基本声明与创建

可以直接用括号语法创建，比 Tuple.Create() 简洁得多：

var person = ("张三", 28, true); → 编译器推断为 (string, int, bool)
显式指定类型：ValueTuple<string int bool> t = ("李四", 31, false);</string>
给字段起名（增强可读性）：var user = (Name: "王五", Age: 25, IsActive: true);，之后可用 user.Name 访问

解构（Deconstruction）让取值更直观

不用再写 t.Item1、t.Item2，直接拆成变量：

var (name, age, active) = ("赵六", 29, true); → 自动按顺序赋值
也可部分解构：var (name, _, _) = user;（下划线忽略不需要的字段）
方法返回元组时特别方便：var (code, msg) = GetResult();

ValueTuple 作为返回值或参数传递

适合替代 out 参数或小型 DTO：

Procys

AI驱动的发票数据处理

102 查看详情 Procys

返回多个值：public (int sum, int count, double *g) Calculate(int[] nums) { ... }
接收元组参数：void Print((string title, int year) book) => Console.WriteLine($"{book.title} ({book.year})");
注意：ValueTuple 是值类型，传参是复制，大数据量元组（如含大数组）可能影响性能，此时应考虑 class 或 ref 返回

和旧版 Tuple 的主要区别

别混用，避免隐式转换问题：

Tuple<t1></t1> 是类（class），存在堆分配；(T1, T2) 是结构体（struct），栈上分配，无 GC 压力
Tuple 字段固定叫 Item1、Item2；ValueTuple 支持自定义字段名（编译期有效）
Tuple.Create(1, "a") 返回 Tuple<int></int>；而 (1, "a") 是 ValueTuple<int></int>，二者不兼容
.NET Standard 2.0+ 和所有现代 .NET 版本都原生支持 ValueTuple，无需额外引用