讲师中心 微信公众号
AI工具推荐 视频效率加速

C# 元组Tuple使用方法 C#如何使用Tuple和ValueTuple

冬静吖_9828

冬静吖_9828

发布时间:2026-02-10 09:56:04

|

622人浏览过

|

来源于php中文网

原创

ValueTuple 是 C# 7.0+ 官方推荐的元组类型,栈上分配、无装箱、支持命名字段、语法简洁;旧 Tuple 为引用类型、性能差、仅支持 Item1/Item2 命名,已基本弃用。

c# 元组tuple使用方法 c#如何使用tuple和valuetuple

ValueTuple 是 C# 7.0+ 的默认选择,Tuple 已基本弃用

从 C# 7.0 开始,ValueTuple 成为官方推荐的元组类型:它栈上分配、无装箱开销、支持字段命名、语法简洁;而旧的 Tuple<t1 t2></t1> 是引用类型、不可变、命名只能靠 Item1/Item2,且性能较差。除非维护 .NET Framework 4.6.1 以下老项目,否则一律优先用 ValueTuple。

声明和初始化 ValueTuple 的 3 种常用方式

最常用的是字面量语法,编译器自动推导类型并允许命名;也可显式指定泛型类型或用构造函数(极少用):

  • (int x, string name) person = (25, "Alice"); —— 推导类型 + 自定义字段名,推荐
  • var point = (10, 20); —— 匿名字段名(Item1, Item2),类型由值推断
  • ValueTuple<string int> t = new("Bob", 30);</string> —— 显式泛型,仅在泛型约束或反射场景需要

注意:var 声明时若用字面量,字段名会丢失(var t = (a: 1, b: "x") 中 t.a 仍可访问,但类型是匿名元组;真正保留命名需声明具体类型或使用 var + 解构)。

解构赋值让 ValueTuple 用起来像普通变量

这是 ValueTuple 最实用的特性之一,避免反复写 t.Item1 或 t.name:

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • var (age, name) = person; —— 直接解构成局部变量,类型和名称由元组定义决定
  • (int a, string n) = person; —— 显式指定类型,适用于需要强类型转换的场景
  • 方法返回元组时可直接解构:var (status, msg) = GetResult();

解构要求变量数量、顺序、可隐式转换的类型必须匹配;否则编译报错 CS8135。不支持跳过某项(如 (_, string n) = t 在 C# 7.0 不合法,C# 7.1+ 才支持弃元 _)。

ValueTuple 的坑:相等性、序列化与跨 Assembly 兼容性

ValueTuple 重载了 Equals() 和 GetHashCode(),按字段值逐个比较,这点比 Tuple<t></t> 更直观;但它不是“纯数据契约”,有几处容易踩雷:

  • JSON 序列化(如 Newtonsoft.Json)默认不识别命名字段,会序列化成 {"Item1":25,"Item2":"Alice"},除非启用 ValueTupleConverter 或用 System.Text.Json(.NET Core 3.0+ 原生支持命名)
  • 跨程序集传递命名元组时,字段名信息只存在于元数据中,接收方若没引用相同版本的 System.ValueTuple NuGet 包(或目标框架不内置),可能退化为 Item1 访问
  • ValueTuple 是可变结构体,修改字段(如 t.x = 99)不会影响其他引用它的变量(因为是值拷贝),这点和很多人直觉不符

如果需要跨服务、存数据库或长期持久化,别依赖 ValueTuple 的字段名——用 record 或自定义 class 更稳妥。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2275

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3702

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1236

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4279

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7239

2023.08.02

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5274

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

5451

2025.07.04

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7239

2023.08.02

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn