Classe Tuple

Represents an ordered collection of members from different hierarchies.

Hiérarchie d'héritage

System. . :: . .Object
  Microsoft.AnalysisServices.AdomdClient..::..Tuple

Espace de noms :  Microsoft.AnalysisServices.AdomdClient
Assembly :  Microsoft.AnalysisServices.AdomdClient (en Microsoft.AnalysisServices.AdomdClient.dll)

Syntaxe

'Déclaration
Public NotInheritable Class Tuple
'Utilisation
Dim instance As Tuple
public sealed class Tuple
public ref class Tuple sealed
[<SealedAttribute>]
type Tuple =  class end
public final class Tuple

Le type Tuple expose les membres suivants.

Propriétés

  Nom Description
Propriété publique Members Gets an instance of the MemberCollection class from the Tuple.
Propriété publique TupleOrdinal Gets the ordinal position of the Tuple.

Haut de la page

Méthodes

  Nom Description
Méthode publique Equals Determines whether two instances of System..::..Object are equal. (remplace Object. . :: . .Equals(Object).)
Méthode protégée Finalize (hérité de Object.)
Méthode publique GetHashCode Serves as a hash function for a particular type, for use in hashing algorithms and data structures such as hash tables. (remplace Object. . :: . .GetHashCode() () () ().)
Méthode publique GetType (hérité de Object.)
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode publique ToString (hérité de Object.)

Haut de la page

Opérateurs

  Nom Description
Opérateur publicMembre statique Equality Determines whether two specified instances of Tuple are equal.
Opérateur publicMembre statique Inequality Determines whether two specified instances of Tuple are not equal.

Haut de la page

Notes

A tuple consists of an ordered collection of members.

A tuple cannot contain more than one member from any single hierarchy.

In ADOMD.NET, a Tuple is used to represent a tuple by encapsulating the collection of Member objects that define the tuple. Tuple objects can be referenced only through the Tuples property of a Set.

Exemples

The following function, given a Tuple, examines the object and returns a Multidimensional Expressions (MDX) string representation of the tuple:

Public Function GetTupleString(ByRef TupleToConvert As Tuple) As String
    If TupleToConvert Is Nothing Then
        Throw New System.ArgumentNullException("TupleToConvert")
    Else
        Dim tupleCount As Integer = TupleToConvert.Members.Count
        Dim tupleIndex As Integer = 0

        If tupleCount = 0 Then
            ' An empty tuple.
            Return "()"
        Else
            ' Iterate through each member in the Members collection,
            ' adding the value of the UniqueName property to a
            ' string.
            ' Because a tuple can represent many members, this
            ' example uses a StringBuilder object to improve
            ' string handling performance.
            Dim tupleString As New _
                System.Text.StringBuilder(15 * tupleCount)

            ' Tuples are framed with parentheses, with each member
            ' within a tuple separated by a comma.
            tupleString.Append("(")
            For tupleIndex = 0 To tupleCount - 1
                tupleString.Append( _
                TupleToConvert.Members(tupleIndex).UniqueName)
                If tupleIndex < (tupleCount - 1) Then
                    tupleString.Append(", ")
                End If
            Next
            tupleString.Append(")")

            Return tupleString.ToString
        End If
    End If
End Function

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.