Measure Class

 

Updated: March 10, 2016

Represents a measure within a cube or measure group.

Namespace:   Microsoft.AnalysisServices.AdomdClient
Assembly:  Microsoft.AnalysisServices.AdomdClient (in Microsoft.AnalysisServices.AdomdClient.dll)

System.Object
  Microsoft.AnalysisServices.AdomdClient.Measure

public sealed class Measure

NameDescription
System_CAPS_pubpropertyCaption

Gets the caption of the Measure.

System_CAPS_pubpropertyDescription

Gets the description of the Measure.

System_CAPS_pubpropertyDisplayFolder

This member is reserved for future use.

System_CAPS_pubpropertyExpression

Gets the Multidimensional Expressions (MDX) expression that is used to aggregate the Measure.

System_CAPS_pubpropertyName

Gets the name of the Measure.

System_CAPS_pubpropertyNumericPrecision

Gets the numeric precision value for the Measure.

System_CAPS_pubpropertyNumericScale

Gets the numeric scale for the Measure.

System_CAPS_pubpropertyParentCube

Gets a CubeDef that contains the Measure.

System_CAPS_pubpropertyProperties

Gets an AdomdPropertyCollection that contains the properties associated with the Measure.

System_CAPS_pubpropertyUniqueName

Gets the unique name of the Measure.

System_CAPS_pubpropertyUnits

Gets a description of the unit of measure for the Measure.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether two instances of Measure are equal.(Overrides Object.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures such as hash tables.(Overrides Object.GetHashCode().)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a String that represents the current instance of the Measure.(Overrides Object.ToString().)

NameDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(Measure, Measure)

Determines whether two instances of Measure are equal.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Measure, Measure)

Determines whether two instances of Measure are unequal.

A measure represents the data within a fact table that is being organized and aggregated by the cube.

In ADOMD.NET, the Measure represents the metadata for a measure within a cube. A measure is not explicitly identified in a cellset, because a measure is treated as a member for querying purposes and is represented by a Measure within the Measures collection of a CubeDef.

The following subroutine, given a CubeDef, iterates through the Measures collection and displays information for each Measure:

Public Sub ListMeasures(ByRef CubeToCheck As CubeDef)

    ' Check the parameter before performing actions on it.
    If CubeToCheck Is Nothing Then
        Throw New System.ArgumentNullException("CubeToCheck")
    Else
        ' Iterate through the Measures collection of the
        ' CubeDef object.

        Try
            Dim measureToCheck As Measure

            Debug.WriteLine("Found " & CubeToCheck.Measures.Count & _
                " measure(s) in cube:")

            For Each measureToCheck In CubeToCheck.Measures
                Debug.WriteLine("Measure:  " & measureToCheck.Name)
                Debug.WriteLine("  Caption:        " & _
                    measureToCheck.Caption)
                Debug.WriteLine("  Description:    " & _
                    measureToCheck.Description)

            Next
        Catch ex As AdomdConnectionException
            ' The connection could not be opened or was disconnected.
            ' This error can occur at any time, if the provider is 
            ' disconnected from the server.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As AdomdErrorResponseException
            ' A response is received from a provider which indicates an error.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As AdomdUnknownResponseException
            ' A response has been returned from the provider that 
            ' was not understood.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As AdomdCacheExpiredException
            ' A cached version of an ADOMD.NET object is no longer valid.
            ' This error is typically raised when reviewing metadata.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As AdomdException
            ' Any other error raised by ADOMD.NET.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As Exception
            ' Any other error.
            Debug.WriteLine(ex)
            Throw ex
        End Try
    End If
End Sub

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: