ValueTuple<T1,T2,T3> 结构

定义

命名空间:

System

程序集:

System.Runtime.dll

程序集:

System.ValueTuple.dll

程序集:

mscorlib.dll

程序集:

netstandard.dll

表示含有 3 个组件的值元组。

generic <typename T1, typename T2, typename T3>
public value class ValueTuple : IComparable, IComparable<ValueTuple<T1, T2, T3>>, IEquatable<ValueTuple<T1, T2, T3>>, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple

generic <typename T1, typename T2, typename T3>
public value class ValueTuple : IComparable, IComparable<ValueTuple<T1, T2, T3>>, IEquatable<ValueTuple<T1, T2, T3>>, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable

public struct ValueTuple<T1,T2,T3> : IComparable, IComparable<(T1, T2, T3)>, IEquatable<(T1, T2, T3)>, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple

public struct ValueTuple<T1,T2,T3> : IComparable, IComparable<(T1, T2, T3)>, IEquatable<(T1, T2, T3)>, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

[System.Serializable]
public struct ValueTuple<T1,T2,T3> : IComparable, IComparable<(T1, T2, T3)>, IEquatable<(T1, T2, T3)>, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

type ValueTuple<'T1, 'T2, 'T3> = struct
    interface ITuple

type ValueTuple<'T1, 'T2, 'T3> = struct

[<System.Serializable>]
type ValueTuple<'T1, 'T2, 'T3> = struct
    interface ITuple

Public Structure ValueTuple(Of T1, T2, T3)
Implements IComparable, IComparable(Of ValueTuple(Of T1, T2, T3)), IEquatable(Of ValueTuple(Of T1, T2, T3)), IStructuralComparable, IStructuralEquatable, ITuple

Public Structure ValueTuple(Of T1, T2, T3)
Implements IComparable, IComparable(Of ValueTuple(Of T1, T2, T3)), IEquatable(Of ValueTuple(Of T1, T2, T3)), IStructuralComparable, IStructuralEquatable

类型参数

T1

值元组的第 1 个元素的类型。

T2

值元组的第 2 个元素的类型。

T3

值元组的第 3 个元素的类型。

继承

Object

ValueType

ValueTuple<T1,T2,T3>

属性

SerializableAttribute

实现

IStructuralComparable IStructuralEquatable IComparable IComparable<ValueTuple<T1,T2,T3>> IEquatable<ValueTuple<T1,T2,T3>> ITuple

注解

值元组是具有特定数目和值序列的数据结构。 结构 ValueTuple<T1,T2,T3> 表示具有三个元素的值元组。

值元组类型不同于元组类型 (，例如 Tuple<T1,T2,T3>) ，如下所示：

• 它们是 (值类型) 而不是 (引用类型的类) 的结构。

• 成员（例如 Item1 和 Item2 字段）而不是属性。

• 其字段是可变的，而不是只读的。

值元组类型提供运行时实现，该实现支持 C# 中的元组 和 F# 中的结构元组。 除了使用语言语法创建 ValueTuple<T1,T2,T3> 实例外，还可以调用 Create 工厂方法。

序列化和值元组

该ValueTuple<T1,T2,T3>类型在 .NET Core 1.x 或 .NET Framework 4.7 及更低版本中不可序列化。 此外，.NET Standard（包括 .NET Standard 2.0）不强制序列化 ValueTuple<T1,T2,T3> 实例;实例是否 ValueTuple<T1,T2,T3> 可序列化取决于单个 .NET Standard 实现。 若要确定类型是否 ValueTuple<T1,T2,T3> 在特定 .NET 实现上可序列化，请获取一个 Type 对象，该对象表示 ValueTuple<T1,T2,T3> 该类型并检索其 IsSerializable 属性的值。 有关 .NET Core 和.NET Framework中可序列化类型的列表，请参阅二进制序列化。

构造函数

ValueTuple<T1,T2,T3>(T1, T2, T3)

初始化一个新 ValueTuple<T1,T2,T3> 实例。

字段

Item1	获取当前 ValueTuple<T1,T2,T3> 实例的第 1 个元素的值。
Item2	获取当前 ValueTuple<T1,T2,T3> 实例的第 2 个元素的值。
Item3	获取当前 ValueTuple<T1,T2,T3> 实例的第 3 个元素的值。

方法

CompareTo(ValueTuple<T1,T2,T3>)	将当前 ValueTuple<T1,T2,T3> 实例与指定的 ValueTuple<T1,T2,T3> 实例进行比较。
Equals(Object)	返回一个值，该值指示当前 ValueTuple<T1,T2,T3> 实例是否与指定的对象相等。
Equals(ValueTuple<T1,T2,T3>)	返回一个值，该值指示当前 ValueTuple<T1,T2,T3> 实例是否与指定的 ValueTuple<T1,T2,T3> 实例相等。
GetHashCode()	计算当前 ValueTuple<T1,T2,T3> 实例的哈希代码。
ToString()	返回表示此 ValueTuple<T1,T2,T3> 实例的值的字符串。

显式接口实现

IComparable.CompareTo(Object)	使用指定的比较器比较当前 ValueTuple<T1,T2,T3> 实例与指定对象，并返回一个整数，该整数指示当前对象在排序顺序中的位置：是在指定对象之前、之后还是在与指定对象相同的位置。
IStructuralComparable.CompareTo(Object, IComparer)	使用指定的比较器比较当前 ValueTuple<T1,T2,T3> 实例与指定对象，并返回一个整数，该整数指示当前对象在排序顺序中的位置：是在指定对象之前、之后还是在与指定对象相同的位置。
IStructuralEquatable.Equals(Object, IEqualityComparer)	返回一个值，该值指示基于指定的比较方法，当前 ValueTuple<T1,T2,T3> 实例是否与指定的对象相等。
IStructuralEquatable.GetHashCode(IEqualityComparer)	通过使用指定计算方法计算当前 ValueTuple<T1,T2,T3> 实例的哈希代码。
ITuple.Item[Int32]	获取指定 ValueTuple 元素的值。
ITuple.Length	获取 ValueTuple 中的元素数。

扩展方法

ToTuple<T1,T2,T3>(ValueTuple<T1,T2,T3>)

将 ValueTuple 结构的实例转换为 Tuple 类的实例。