Tuple Sınıf

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Source:

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 sayıda ve öğe dizisine sahip bir veri yapısıdır. Tanımlama grubuna örnek olarak, ilk öğede bir kişinin adı, ikinci öğede bir yıl ve üçüncü öğede söz konusu kişinin o yıla ait geliri gibi bir tanımlayıcıyı depolamak için kullanılan üç öğeli (3 tanımlama grubu veya üçlü olarak bilinir) olan bir 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 demetler oluşturabilirsiniz.

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

• Tek bir veri kümesi göstermek için. Örneğin, bir kayıt düzeni, bir veritabanı kaydını temsil edebilir ve bileşenler ise tek tek kaydın alanlarını temsil edebilir.

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

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

• Birden çok değeri tek bir parametre ile bir yönteme 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 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 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şene (sekizli kümeler aracılığıyla tekiller) sahip tanımlama grubu nesnelerinin oluşturulmasını doğrudan destekler. Bir tanımlama grubunun 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.

Not

Tanımlama grubu kullanan ek bilgi ve örnekler için .NET Framework tek tek tanımlama grubu türlerinin belgelerine bakın. Bunlar, bu konunun sonundaki Ayrıca Bkz. bölümünde listelenmiştir.

Yöntemler

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 cinsiyet grubu oluşturur.
Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)	Yeni bir 5 tanımlama grubu veya beşli tanımlama grubu 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 üçlü 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>