Tuple 클래스

정의

튜플 개체를 작성하는 정적 메서드를 제공합니다.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
상속
Tuple

예제

다음 예제에서는 8-튜플을 (옥 튜플) 20 보다 작은 소수를 포함 하는 만듭니다.The following example creates an 8-tuple (octuple) that contains prime numbers that are less than 20.

var primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19);
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19
Dim primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1)
' The example displays the following output:
'     Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19

설명

튜플은 요소의 시퀀스를 특정 수 있는 데이터 구조입니다.A tuple is a data structure that has a specific number and sequence of elements. 튜플을 예로 첫 번째 요소에서 세 번째 요소에 해당 연도 대 한 두 번째 요소인 및 개인의 소득이 연간 사람의 이름과 같은 식별자를 저장 하는 데 사용 되는 세 가지 요소 (3-튜플 또는 셋을로 알려짐)를 사용 하 여 데이터 구조입니다.An example of a tuple is a data structure with three elements (known as a 3-tuple or triple) that is used to store an identifier such as a person's name in the first element, a year in the second element, and the person's income for that year in the third element. .NET Framework는 1 ~ 7 요소를 사용 하 여 튜플 직접 지원합니다.The .NET Framework directly supports tuples with one to seven elements. 또한에서 튜플 개체를 중첩 하 여 튜플을 8 개 이상의 요소를 만들 수 있습니다 합니다 Rest 의 속성을 Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> 개체입니다.In addition, you can create tuples of eight or more elements by nesting tuple objects in the Rest property of a Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> object.

튜플의 네 가지 방법으로 일반적으로 사용 됩니다.Tuples are commonly used in four ways:

  • 단일 데이터 집합을 나타냅니다.To represent a single set of data. 예를 들어, 튜플을 데이터베이스 레코드를 나타내고 해당 구성 요소 레코드의 개별 필드를 나타낼 수 있습니다.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • 쉽게 액세스 및 조작, 데이터 집합을 제공 합니다.To provide easy access to, and manipulation of, a data set.

  • 사용 하지 않고 메서드에서 여러 값을 반환할 out 매개 변수 (C#) 또는 ByRef 매개 변수 (Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • 단일 매개 변수를 통해 메서드에 여러 값을 전달 하 합니다.To pass multiple values to a method through a single parameter. 예를 들어를 Thread.Start(Object) 메서드 시작 시에 스레드가 실행 되는 메서드에 하나의 값을 제공할 수 있는 단일 매개 변수가 있습니다.For example, the Thread.Start(Object) method has a single parameter that lets you supply one value to the method that the thread executes at startup time. 제공 하는 경우는 Tuple<T1,T2,T3> 개체의 메서드 인수를 3 개 데이터 항목을 사용 하 여 스레드의 시작 루틴을 제공할 수 있습니다.If you supply a Tuple<T1,T2,T3> object as the method argument, you can supply the thread's startup routine with three items of data.

Tuple 클래스 자체 나타내지 튜플입니다.The Tuple class does not itself represent a tuple. 대신,.NET Framework에서 지원 되는 튜플 형식의 인스턴스를 만들기 위한 정적 메서드를 제공 하는 클래스입니다.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. 각 튜플 구성 요소의 형식을 명시적으로 지정할 필요가 없는 튜플 개체를 인스턴스화하기 위해 호출할 수 있는 도우미 메서드를 제공 합니다.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

해당 클래스 생성자를 호출 하 여 튜플 클래스의 인스턴스를 만들 수 있습니다, 있지만 이렇게 하려면 코드 복잡할 수 있습니다.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. 다음 예제에서는 클래스 생성자를 사용 하 여 7-튜플을 만드는 데 또는 각 1950 2000 년 인구 조사에 대 한 New York City에 대 한 인구 데이터가 포함 된 일곱 합니다.The following example uses a class constructor to create a 7-tuple or septuple that contains population data for New York City for each census from 1950 through 2000.

// Create a 7-tuple.
var population = new Tuple<string, int, int, int, int, int, int>(
                           "New York", 7891957, 7781984, 
                           7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278
' Create a 7-tuple.
Dim population As New Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer) _
                           ("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
' Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7)
' The example displays the following output:
'        Population of New York in 2000: 8,008,278

도우미 메서드를 사용 하 여 동일한 튜플 개체를 만들기는 다음 예제와 같이 더 간단 합니다.Creating the same tuple object by using a helper method is more straightforward, as the following example shows.

// Create a 7-tuple.
var population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278
' Create a 7-tuple.
Dim population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
' Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7)
' The example displays the following output:
'        Population of New York in 2000: 8,008,278

Create 도우미 메서드는 직접 1 ~ 8 개의 구성 요소 (즉, 단일 항목 옥 통해) 된 튜플 개체의 생성을 지원 합니다.The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). 구성 요소 수에 실제적인 제한은 없지만 튜플을 발생할 수 있으며, 도우미 메서드는 9 개 이상의 구성 요소를 사용 하 여 튜플을 만드는 데 사용할 수 없습니다.Although there is no practical limit to the number of components a tuple may have, helper methods are not available to create a tuple with nine or more components. 이러한 튜플 만들기를 호출 해야 합니다 Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> 생성자입니다.To create such a tuple, you must call the Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> constructor.

참고

튜플을 사용 하는 예제와 추가 정보에 대 한.NET Framework의 개별 튜플 형식에 대 한 설명서를 참조 하세요.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. 이러한 작업은이 항목의 끝에 있는 참고 항목 섹션에 나열 됩니다.These are listed in the See Also section at the end of this topic.

메서드

Create<T1,T2,T3,T4,T5,T6,T7,T8>(T1, T2, T3, T4, T5, T6, T7, T8)

8개의 요소로 구성된 새 튜플을 만듭니다.Creates a new 8-tuple, or octuple.

Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

7개의 요소로 구성된 새 튜플 또는 7중을 만듭니다.Creates a new 7-tuple, or septuple.

Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)

6개의 요소로 구성된 새 튜플 또는 6중을 만듭니다.Creates a new 6-tuple, or sextuple.

Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

5개의 요소로 구성된 새 튜플 또는 5중을 만듭니다.Creates a new 5-tuple, or quintuple.

Create<T1,T2,T3,T4>(T1, T2, T3, T4)

4개의 요소로 구성된 새 튜플 또는 4중을 만듭니다.Creates a new 4-tuple, or quadruple.

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

3개의 요소로 구성된 새 튜플 또는 3중을 만듭니다.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2)

2개의 요소로 구성된 새 튜플 또는 쌍을 만듭니다.Creates a new 2-tuple, or pair.

Create<T1>(T1)

1개의 요소로 구성된 새 튜플 또는 singleton을 만듭니다.Creates a new 1-tuple, or singleton.

적용 대상

추가 정보