Tuple<T1,T2> Klasse
Definition
Stellt ein 2-Tupel (Paar) dar.Represents a 2-tuple, or pair.
generic <typename T1, typename T2>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable
generic <typename T1, typename T2>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple
public class Tuple<T1,T2> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable
public class Tuple<T1,T2> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple
[System.Serializable]
public class Tuple<T1,T2> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable
type Tuple<'T1, 'T2> = class
interface IStructuralComparable
interface IStructuralEquatable
interface IComparable
type Tuple<'T1, 'T2> = class
interface IStructuralComparable
interface IStructuralEquatable
interface IComparable
interface ITuple
[<System.Serializable>]
type Tuple<'T1, 'T2> = class
interface IStructuralEquatable
interface IStructuralComparable
interface IComparable
[<System.Serializable>]
type Tuple<'T1, 'T2> = class
interface IStructuralEquatable
interface IStructuralComparable
interface IComparable
interface ITuple
Public Class Tuple(Of T1, T2)
Implements IComparable, IStructuralComparable, IStructuralEquatable
Public Class Tuple(Of T1, T2)
Implements IComparable, IStructuralComparable, IStructuralEquatable, ITuple
Typparameter
- T1
Der Typ der ersten Komponente des Tupels.The type of the tuple's first component.
- T2
Der Typ der zweiten Komponente des Tupels.The type of the tuple's second component.
- Vererbung
-
Tuple<T1,T2>
- Attribute
- Implementiert
Hinweise
Ein Tupel ist eine Datenstruktur, die über eine bestimmte Anzahl und Sequenz von Werten verfügt.A tuple is a data structure that has a specific number and sequence of values. Die- Tuple<T1,T2> Klasse stellt ein 2-Tupel-oder-Paar dar, bei dem es sich um ein Tupel mit zwei Komponenten handelt.The Tuple<T1,T2> class represents a 2-tuple, or pair, which is a tuple that has two components. Ein 2-Tupel ähnelt einer- KeyValuePair<TKey,TValue> Struktur.A 2-tuple is similar to a KeyValuePair<TKey,TValue> structure.
Sie können ein-Objekt instanziieren, Tuple<T1,T2> indem Sie entweder den- Tuple<T1,T2> Konstruktor oder die statische- Tuple.Create<T1,T2>(T1, T2) Methode aufrufen.You can instantiate a Tuple<T1,T2> object by calling either the Tuple<T1,T2> constructor or the static Tuple.Create<T1,T2>(T1, T2) method. Sie können die Werte der tupelkomponenten abrufen, indem Sie die schreibgeschützten Item1 Item2 Eigenschaften und Instanzeigenschaften verwenden.You can retrieve the values of the tuple's components by using the read-only Item1 and Item2 instance properties.
Tupel werden üblicherweise auf vier verschiedene Arten verwendet:Tuples are commonly used in four different ways:
, Um einen einzelnen Satz von Daten darzustellen.To represent a single set of data. Beispielsweise kann ein Tupel einen Datensatz in einer Datenbank darstellen, und seine Komponenten können die Felder dieses Datensatzes darstellen.For example, a tuple can represent a record in a database, and its components can represent that record's fields.
, Um einen einfachen Zugriff auf ein DataSet und die Bearbeitung von Daten zu ermöglichen.To provide easy access to, and manipulation of, a data set. Im folgenden Beispiel wird ein Array von Tuple<T1,T2> -Objekten definiert, die die Namen der Schüler/Studenten und ihre entsprechenden Testergebnisse enthalten.The following example defines an array of Tuple<T1,T2> objects that contain the names of students and their corresponding test scores. Anschließend wird das Array durchlaufen, um die mittlere Testbewertung zu berechnen.It then iterates the array to calculate the mean test score.
using System; public class Example { public static void Main() { Tuple<string, Nullable<int>>[] scores = { new Tuple<string, Nullable<int>>("Jack", 78), new Tuple<string, Nullable<int>>("Abbey", 92), new Tuple<string, Nullable<int>>("Dave", 88), new Tuple<string, Nullable<int>>("Sam", 91), new Tuple<string, Nullable<int>>("Ed", null), new Tuple<string, Nullable<int>>("Penelope", 82), new Tuple<string, Nullable<int>>("Linda", 99), new Tuple<string, Nullable<int>>("Judith", 84) }; int number; double mean = ComputeMean(scores, out number); Console.WriteLine("Average test score: {0:N2} (n={1})", mean, number); } private static double ComputeMean(Tuple<string, Nullable<int>>[] scores, out int n) { n = 0; int sum = 0; foreach (var score in scores) { if (score.Item2.HasValue) { n += 1; sum += score.Item2.Value; } } if (n > 0) return sum / (double) n; else return 0; } } // The example displays the following output: // Average test score: 87.71 (n=7)
Module Example Public Sub Main() Dim scores() As Tuple(Of String, Nullable(Of Integer)) = { New Tuple(Of String, Nullable(Of Integer))("Jack", 78), New Tuple(Of String, Nullable(Of Integer))("Abbey", 92), New Tuple(Of String, Nullable(Of Integer))("Dave", 88), New Tuple(Of String, Nullable(Of Integer))("Sam", 91), New Tuple(Of String, Nullable(Of Integer))("Ed", Nothing), New Tuple(Of String, Nullable(Of Integer))("Penelope", 82), New Tuple(Of String, Nullable(Of Integer))("Linda", 99), New Tuple(Of String, Nullable(Of Integer))("Judith", 84) } Dim number As Integer Dim mean As Double = ComputeMean(scores, number) Console.WriteLine("Average test score: {0:N2} (n={1})", mean, number) End Sub Private Function ComputeMean(scores() As Tuple(Of String, Nullable(Of Integer)), ByRef n As Integer) As Double n = 0 Dim sum As Integer For Each score In scores If score.Item2.HasValue Then n += 1 sum += score.Item2.Value End If Next If n > 0 Then Return sum / n Else Return 0 End If End Function End Module ' The example displays the following output: ' Average test score: 87.71 (n=7)
, Wenn mehrere Werte aus einer Methode ohne Verwendung von
out
Parametern (in c#) oderByRef
Parametern (in Visual Basic) zurückgegeben werden sollen.To return multiple values from a method without the use ofout
parameters (in C#) orByRef
parameters (in Visual Basic). Im folgenden Beispiel wird z Tuple<T1,T2> . b. ein-Objekt verwendet, um den Quotienten und den Rest zurückzugeben, der aus der ganzzahligen Division resultiert.For example, the following example uses a Tuple<T1,T2> object to return the quotient and the remainder that result from integer division.using System; public class Class1 { public static void Main() { int dividend, divisor; Tuple<int, int> result; dividend = 136945; divisor = 178; result = IntegerDivide(dividend, divisor); if (result != null) Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", dividend, divisor, result.Item1, result.Item2); else Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor); dividend = Int32.MaxValue; divisor = -2073; result = IntegerDivide(dividend, divisor); if (result != null) Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", dividend, divisor, result.Item1, result.Item2); else Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor); } private static Tuple<int, int> IntegerDivide(int dividend, int divisor) { try { int remainder; int quotient = Math.DivRem(dividend, divisor, out remainder); return new Tuple<int, int>(quotient, remainder); } catch (DivideByZeroException) { return null; } } } // The example displays the following output: // 136945 \ 178 = 769, remainder 63 // 2147483647 \ -2073 = -1035930, remainder 757
Module modMain Public Sub Main() Dim dividend, divisor As Integer Dim result As Tuple(Of Integer, Integer) dividend = 136945 : divisor = 178 result = IntegerDivide(dividend, divisor) If result IsNot Nothing Then Console.WriteLine("{0} \ {1} = {2}, remainder {3}", dividend, divisor, result.Item1, result.Item2) Else Console.WriteLine("{0} \ {1} = <Error>", dividend, divisor) End If dividend = Int32.MaxValue : divisor = -2073 result = IntegerDivide(dividend, divisor) If result IsNot Nothing Then Console.WriteLine("{0} \ {1} = {2}, remainder {3}", dividend, divisor, result.Item1, result.Item2) Else Console.WriteLine("{0} \ {1} = <Error>", dividend, divisor) End If End Sub Private Function IntegerDivide(dividend As Integer, divisor As Integer) As Tuple(Of Integer, Integer) Try Dim remainder As Integer Dim quotient As Integer = Math.DivRem(dividend, divisor, remainder) Return New Tuple(Of Integer, Integer)(quotient, remainder) Catch e As DivideByZeroException Return Nothing End Try End Function End Module ' The example displays the following output: ' 136945 \ 178 = 769, remainder 63 ' 2147483647 \ -2073 = -1035930, remainder 757
, Wenn mehrere Werte über einen einzelnen Parameter an eine Methode übergeben werden sollen.To pass multiple values to a method through a single parameter. Beispielsweise verfügt die- Thread.Start(Object) Methode über einen einzelnen Parameter, mit dem Sie einen Wert für die Methode angeben können, die der Thread beim Start ausführt.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. Wenn Sie ein Tuple<T1,T2> -Objekt als Methoden Argument bereitstellen, können Sie die Start Routine des Threads mit zwei Datenelementen bereitstellen.If you supply a Tuple<T1,T2> object as the method argument, you can supply the thread's startup routine with two items of data.
Konstruktoren
Tuple<T1,T2>(T1, T2) |
Initialisiert eine neue Instanz der Tuple<T1,T2>-Klasse.Initializes a new instance of the Tuple<T1,T2> class. |
Eigenschaften
Item1 |
Ruft den Wert der ersten Komponente des aktuellen Tuple<T1,T2>-Objekts ab.Gets the value of the current Tuple<T1,T2> object's first component. |
Item2 |
Ruft den Wert der zweiten Komponente des aktuellen Tuple<T1,T2>-Objekts ab.Gets the value of the current Tuple<T1,T2> object's second component. |
Methoden
Equals(Object) |
Gibt einen Wert zurück, der angibt, ob das aktuelle Tuple<T1,T2>-Objekt gleich einem angegebenen Objekt ist.Returns a value that indicates whether the current Tuple<T1,T2> object is equal to a specified object. |
GetHashCode() |
Gibt den Hashcode für das aktuelle Tuple<T1,T2>-Objekt zurück.Returns the hash code for the current Tuple<T1,T2> object. |
GetType() |
Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die den Wert dieser Tuple<T1,T2>-Instanz darstellt.Returns a string that represents the value of this Tuple<T1,T2> instance. |
Explizite Schnittstellenimplementierungen
IComparable.CompareTo(Object) |
Vergleicht das aktuelle Tuple<T1,T2>-Objekt mit einem angegebenen Objekt und gibt eine Ganzzahl zurück, die darauf hinweist, ob sich das aktuelle Objekt in der Sortierreihenfolge vor oder hinter dem angegebenen Objekt oder an der gleichen Position befindet.Compares the current Tuple<T1,T2> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order. |
IStructuralComparable.CompareTo(Object, IComparer) |
Vergleicht das aktuelle Tuple<T1,T2>-Objekt anhand eines angegebenen Vergleichs mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob sich das aktuelle Objekt in der Sortierreihenfolge vor dem angegebenen Objekt, dahinter oder an derselben Position befindet.Compares the current Tuple<T1,T2> object to a specified object by using a specified comparer, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order. |
IStructuralEquatable.Equals(Object, IEqualityComparer) |
Gibt einen Wert zurück, der auf Grundlage einer angegebenen Vergleichsmethode angibt, ob das aktuelle Tuple<T1,T2>-Objekt gleich einem angegebenen Objekt ist.Returns a value that indicates whether the current Tuple<T1,T2> object is equal to a specified object based on a specified comparison method. |
IStructuralEquatable.GetHashCode(IEqualityComparer) |
Berechnet mit einer angegebenen Berechnungsmethode den Hash für das aktuelle Tuple<T1,T2>-Objekt.Calculates the hash code for the current Tuple<T1,T2> object by using a specified computation method. |
ITuple.Item[Int32] |
Ruft den Wert des angegebenen Elements |
ITuple.Length |
Ruft die Anzahl der Elemente im |
Erweiterungsmethoden
Deconstruct<T1,T2>(Tuple<T1,T2>, T1, T2) |
Dekonstruiert ein Tupel mit zwei Elementen in separate Variablen.Deconstructs a tuple with 2 elements into separate variables. |
ToValueTuple<T1,T2>(Tuple<T1,T2>) |
Konvertiert eine Instanz der |