Compartir a través de


Clase Member

Represents a single member within a hierarchy, tuple, level, or member.

Jerarquía de herencia

System. . :: . .Object
  Microsoft.AnalysisServices.AdomdClient..::..Member

Espacio de nombres:  Microsoft.AnalysisServices.AdomdClient
Ensamblado:  Microsoft.AnalysisServices.AdomdClient (en Microsoft.AnalysisServices.AdomdClient.dll)

Sintaxis

'Declaración
Public NotInheritable Class Member
'Uso
Dim instance As Member
public sealed class Member
public ref class Member sealed
[<SealedAttribute>]
type Member =  class end
public final class Member

El tipo Member expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Caption Gets the caption of the Member.
Propiedad pública ChildCount Gets the estimated count of child members contained in the Member.
Propiedad pública Description Gets the descriptive text of the Member.
Propiedad pública DrilledDown Indicates whether no children immediately follow the member on the axis.
Propiedad pública LevelDepth Gets the ordinal position of the level that contains the Member.
Propiedad pública LevelName Gets the name of the level that contains the Member.
Propiedad pública MemberProperties Gets a MemberPropertyCollection that contains a collection of member properties for the Member.
Propiedad pública Name Gets the name of the Member.
Propiedad pública Parent Gets a reference to the parent Member, if applicable, that contains the Member.
Propiedad pública ParentLevel This property gets a Level that contains the Member.
Propiedad pública ParentSameAsPrevious Returns whether the parent of this position member is the same as the parent of the immediately preceding member.
Propiedad pública Properties Gets a PropertyCollection that contains the properties associated with the Member.
Propiedad pública Type Gets the member type of the Member.
Propiedad pública UniqueName Gets the unique name of the Member.

Arriba

Métodos

  Nombre Descripción
Método público Equals Determines whether two instances of Member are equal. (Invalida Object. . :: . .Equals(Object).)
Método público FetchAllProperties Retrieves all member properties from the server.
Método protegido Finalize (Se hereda de Object.)
Método público GetChildren() () () () Returns a MemberCollection that contains a collection of child members for the Member.
Método público GetChildren(Int64, Int64) Returns a MemberCollection that contains a collection of child members for the Member. The returned object contains up to count members, and begins at the position indicated by start.
Método público GetChildren(Int64, Int64, array<MemberFilter> [] () [] []) Returns a MemberCollection that contains a collection of child members for the Member. The returned object contains up to count members, begins at the position indicated by the start parameter, and is filtered by the filters parameters.
Método público GetChildren(Int64, Int64, array<String> [] () [] [], array<MemberFilter> [] () [] []) Returns a MemberCollection that contains a collection of child members for the Member. The returned object contains up to count members, begins at the position indicated by the start parameter, and is filtered by the filters parameters. Each member caches the properties indicated by the Array passed into the properties parameter. Note   For performance reasons, this overload should be used only if non-default member properties are needed. Default member properties include Name, UniqueName, Caption, ChildCount, Description, LevelDepth, LevelName, Parent, ParentLevel, and Type.
Método público GetHashCode Serves as a hash function for a particular type, for use in hashing algorithms and data structures such as hash tables. (Invalida Object. . :: . .GetHashCode() () () ().)
Método público GetType (Se hereda de Object.)
Método protegido MemberwiseClone (Se hereda de Object.)
Método público ToString A String that contains the name of the Member. (Invalida Object. . :: . .ToString() () () ().)

Arriba

Operadores

  Nombre Descripción
Operador públicoMiembro estático Equality Determines whether two instances of Member are equal.
Operador públicoMiembro estático Inequality Determines whether two instances of Member are unequal.

Arriba

Comentarios

A member is an item in a hierarchy that represents one or more records in the underlying relational database. A member is the lowest level of reference used when accessing cell data in a cube.

Members are used to construct tuples, which in turn are used to construct sets. Members are organized hierarchically; a member can have other members associated with it. For example, in a time dimension that contains three levels named Year, Month, and Day, the members of the Day level are leaf members because they have no child members. The members in the Year and Month levels are nonleaf members, because each member in the Month level has at least 28 child members from the Day level and each member in the Year level has 12 child members from the Month level.

The Member encapsulates the information necessary to describe a member, including a collection of Member objects that contain child members, if applicable.

The information available to a Member depends on the parent of the Members collection from which the Member was retrieved. While the Members collection externally represents a collection of Member objects for a specified Hierarchy, Tuple, Level, or Member, the collection is internally loaded and managed in one of two ways, depending on the parent of the Hierarchy, Tuple, Level, or Member:

  • If the parent object was referenced through a CubeDef in order to retrieve metadata from the server, the collection represents the members that are defined for the parent object.

  • If the parent object was referenced through a CellSet in order to retrieve metadata from a query, the collection represents the members that are retrieved for the set (or axis) that contains the parent object.

Ejemplos

The following subroutine, given a Hierarchy, iterates through the Members collection and displays information for each Member:

Public Overloads Sub ListMembers(ByRef HierarchyToCheck As Hierarchy)

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

        Try
            Dim memberToCheck As Member

            Debug.WriteLine("Found " & HierarchyToCheck.Members.Count & _
                " member(s) in hierarchy:")

            For Each memberToCheck In HierarchyToCheck.Members
                Debug.WriteLine("Member:  " & memberToCheck.Name)
                Debug.WriteLine("  Caption:          " & _
                    memberToCheck.Caption)
                Debug.WriteLine("  UniqueName:       " & _
                    memberToCheck.UniqueName)

                Debug.WriteLine("  No. of children:  " & _
                    memberToCheck.Children.Count)
            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

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.