Tuple Sınıf

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Tuple.cs

Tanımlama grubu nesneleri oluşturmak için statik yöntemler sağlar.

public ref class Tuple abstract sealed

public static class Tuple

type Tuple = class

Public Class Tuple

Devralma

Object

Tuple

Örnekler

Aşağıdaki örnek, 20'den küçük asal sayılar içeren bir 8 tanımlama grubu (sekizli) oluşturur.

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

open System

let primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)
printfn $"Prime numbers less than 20: {primes.Item1}, {primes.Item2}, {primes.Item3}, {primes.Item4}, {primes.Item5}, {primes.Item6}, {primes.Item7}, and {primes.Rest.Item1}"
//    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çıklamalar

Tanımlama grubu, belirli bir öğe sayısına ve dizisine sahip bir veri yapısıdır. Tanımlama grubuna örnek olarak, birinci öğede bir kişinin adı, ikinci öğede bir yıl ve üçüncü öğede o yıla ait gelir gibi bir tanımlayıcıyı depolamak için kullanılan üç öğeli (3 tanımlama grubu veya üçlü olarak bilinir) veri yapısı gösterilebilir. .NET Framework, bir ile yedi arasında öğe içeren tanımlama listelerini doğrudan destekler. Ayrıca, tanımlama grubu nesnelerini bir Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> nesnenin özelliğine iç içe yerleştirerek sekiz veya daha fazla öğeden Rest oluşan tanımlama kümeleri oluşturabilirsiniz.

Tanımlama demetleri yaygın olarak dört şekilde kullanılır:

• Tek bir veri kümesini temsil etmek için. Örneğin, bir tanımlama grubu bir veritabanı kaydını temsil edebilir ve bileşenleri kaydın tek tek alanlarını temsil edebilir.

• Bir veri kümesine kolay erişim ve işleme sağlamak için.

• Bir yöntemden parametre (C#içinde) veya ByRef parametre kullanmadan out (Visual Basic'te) birden çok değer döndürmek için.

• Tek bir parametre aracılığıyla bir yönteme birden çok değer geçirmek için. Örneğin, yöntemi, iş parçacığının Thread.Start(Object) başlangıç zamanında yürüttüğü yönteme tek bir değer sağlamanıza olanak tanıyan tek bir parametreye sahiptir. Yöntem bağımsız değişkeni olarak bir Tuple<T1,T2,T3> nesne sağlarsanız, iş parçacığının başlangıç yordamını üç veri öğesiyle sağlayabilirsiniz.

Sınıfın Tuple kendisi bir tanımlama grubu temsil etmez. Bunun yerine, .NET Framework tarafından desteklenen tanımlama grubu türlerinin örneklerini oluşturmak için statik yöntemler sağlayan bir sınıftır. Her tanımlama grubu bileşeninin türünü açıkça belirtmek zorunda kalmadan tanımlama grubu nesnelerinin örneğini başlatmak için çağırabileceğiniz yardımcı yöntemler sağlar.

Sınıf oluşturucusunu çağırarak bir tanımlama grubu sınıfının örneğini oluşturabilirsiniz, ancak bunu yapmak için gereken kod zahmetli olabilir. Aşağıdaki örnekte, 1950 ile 2000 arasındaki her nüfus sayımı için New York City için nüfus verilerini içeren bir 7 tanımlama grubu veya ayrıştırma oluşturmak için bir sınıf oluşturucu kullanılır.

// 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.
let population = Tuple<string, int, int, int, int, int, int>(
                            "New York", 7891957, 7781984, 
                            7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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

Aşağıdaki örnekte gösterildiği gibi, yardımcı bir yöntem kullanarak aynı tanımlama grubu nesnesini oluşturmak daha kolaydır.

// 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.
let population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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 Yardımcı yöntemler, bir ila sekiz bileşen içeren tanımlama grubu nesnelerinin oluşturulmasını (yani sekizli kümeler aracılığıyla tekiller) doğrudan destekler. Bir demetin sahip olabileceği bileşen sayısı için pratik bir sınır olmasa da, dokuz veya daha fazla bileşen içeren bir tanımlama grubu oluşturmak için yardımcı yöntemler kullanılamaz. Böyle bir tanımlama grubu oluşturmak için oluşturucuyu Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> çağırmanız gerekir.

Uyarı

Tanımlama listelerini kullanan ek bilgi ve örnekler için .NET Framework'teki tek tek tanımlama grubu türlerine yönelik belgelere bakın. Bunlar, bu konunun sonundaki Ayrıca Bkz. bölümünde listelenir.

Yöntemler

Name	Description
Create<T1,T2,T3,T4,T5,T6,T7,T8>(T1, T2, T3, T4, T5, T6, T7, T8)	Yeni bir 8 tanımlama grubu veya sekizli oluşturur.
Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)	Yeni bir 7 tanımlama grubu veya ayrıştırma oluşturur.
Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)	Yeni bir 6 tanımlama grubu veya sextuple oluşturur.
Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)	Yeni bir 5 tanımlama grubu veya beşli oluşturur.
Create<T1,T2,T3,T4>(T1, T2, T3, T4)	Yeni bir 4 tanımlama grubu veya dörtlü oluşturur.
Create<T1,T2,T3>(T1, T2, T3)	Yeni bir 3 tanımlama grubu veya üç kişilik bir tanımlama grubu oluşturur.
Create<T1,T2>(T1, T2)	Yeni bir 2 tanımlama grubu veya çift oluşturur.
Create<T1>(T1)	Yeni bir 1 tanımlama grubu veya tekil oluşturur.

Ayrıca bkz.

• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• Tuple<T1,T2,T3,T4>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>