Tuple Sınıf

Tanım

Demet nesneleri oluşturmak için statik yöntemler sağlar.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Devralma
Tuple

Örnekler

Aşağıdaki örnek, 20 ' den küçük olan asal sayılar içeren 8 demet (octuple) oluşturur.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çıklamalar

Kayıt düzeni, belirli bir sayı ve öğe sırası olan bir veri yapısıdır.A tuple is a data structure that has a specific number and sequence of elements. Bir tanımlama grubu örneği, bir kişinin adı gibi bir tanımlayıcıyı ilk öğede, ikinci öğedeki bir yılda ve kişinin söz konusu yıla ait geliri üçüncü öğede depolamak için kullanılan üç öğe (3 tanımlama grubu veya üçlü olarak bilinir) olan bir veri yapısıdır.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, bir ile yedi arasında öğe olan tanımlama gruplarını doğrudan destekler.The .NET Framework directly supports tuples with one to seven elements. Ayrıca, bir nesnenin özelliğine demet nesneleri iç içe aktararak sekiz veya daha fazla öğe için tanımlama grupları oluşturabilirsiniz 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.

Tanımlama grupları yaygın olarak dört şekilde kullanılır:Tuples are commonly used in four ways:

  • Tek bir veri kümesi göstermek için.To represent a single set of data. Ö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.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • Bir veri kümesine kolay erişim ve düzenleme sağlamak için.To provide easy access to, and manipulation of, a data set.

  • outParametreleri (C# ' de) veya parametreleri kullanmadan bir yöntemden birden çok değer döndürmek için ByRef (Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Birden çok değeri tek bir parametre ile bir yönteme geçirmek için.To pass multiple values to a method through a single parameter. Örneğin, yönteminin, Thread.Start(Object) iş parçacığının başlangıç zamanında yürüttüğü yönteme bir değer sağlamanıza olanak tanıyan tek bir parametresi vardır.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>Yöntem bağımsız değişkeni olarak bir nesnesi sağlarsanız, iş parçacığının başlangıç yordamını üç veri öğesi ile sağlayabilirsiniz.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.

TupleSınıf kendisini bir tanımlama grubu temsil etmez.The Tuple class does not itself represent a tuple. Bunun yerine, .NET Framework tarafından desteklenen demet türlerinin örneklerini oluşturmak için statik yöntemler sağlayan bir sınıftır.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. Her demet bileşeni türünü açık bir şekilde belirtmek zorunda kalmadan demet nesnelerinin örneğini oluşturmak için çağırabilmeniz gereken yardımcı yöntemler sağlar.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

Sınıf oluşturucusunu çağırarak demet sınıfının bir örneğini oluşturabilirsiniz, ancak bunu yapmak için gereken kod çok sayıda olabilir.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. Aşağıdaki örnek, 1950 ile 2000 arasında her görselleştirmenizdeki için New York City için popülasyon verilerini içeren 7 tanımlama grubu veya seponu oluşturmak için bir sınıf Oluşturucu kullanır.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

Aşağıdaki örnekte gösterildiği gibi, bir yardımcı yöntemi kullanarak aynı demet nesnesinin oluşturulması daha basittir.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

CreateYardımcı yöntemler, bir ila sekiz bileşenden (yani, octuple aracılığıyla tekton) sahip olan demet nesnelerinin oluşturulmasını doğrudan destekler.The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). Bir demet 'nin sahip olabileceği bileşen sayısında pratik bir sınır olmasa da, dokuz veya daha fazla bileşeni olan bir tanımlama grubu oluşturmak için yardımcı yöntemler kullanılamaz.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. Böyle bir tanımlama grubu oluşturmak için oluşturucuyu çağırmanız gerekir 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.

Not

Tanımlama bilgilerini kullanan ek bilgiler ve örnekler için .NET Framework bireysel demet türlerine yönelik belgelere bakın.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Bunlar, bu konunun sonundaki Ayrıca bkz. bölümünde listelenmiştir.These are listed in the See Also section at the end of this topic.

Yöntemler

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

Yeni bir 8 demet veya bir tanımlama grubu oluşturur.Creates a new 8-tuple, or octuple.

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

Yeni bir 7 kayıt düzeni veya seponun oluşturur.Creates a new 7-tuple, or septuple.

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

Yeni bir 6 demet veya sextuple oluşturur.Creates a new 6-tuple, or sextuple.

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

Yeni bir 5 demet veya daha fazla tanımlama grubu oluşturur.Creates a new 5-tuple, or quintuple.

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

Yeni 4 demet veya dörtlü oluşturur.Creates a new 4-tuple, or quadruple.

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

Yeni bir 3 tanımlama grubu veya üçlü oluşturur.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2)

Yeni bir 2 demet veya çift oluşturur.Creates a new 2-tuple, or pair.

Create<T1>(T1)

Yeni bir 1 demet veya tek oluşturur.Creates a new 1-tuple, or singleton.

Şunlara uygulanır

Ayrıca bkz.