Member クラス

階層、組、レベル、またはメンバー内の単一メンバーを表します。

継承階層

System.Object
  Microsoft.AnalysisServices.AdomdClient.Member

名前空間:  Microsoft.AnalysisServices.AdomdClient
アセンブリ:  Microsoft.AnalysisServices.AdomdClient (Microsoft.AnalysisServices.AdomdClient.dll)

構文

'宣言
Public NotInheritable Class Member
'使用
Dim instance As Member

public sealed class Member

public ref class Member sealed

[<SealedAttribute>]
type Member =  class end

public final class Member

Member 型は、以下のメンバーを公開しています。

プロパティ

	名前	説明
	Caption	Member のキャプションを取得します。
	ChildCount	Member に含まれる子メンバーの推定数を取得します。
	Description	Member の説明のテキストを取得します。
	DrilledDown	軸にメンバーのすぐ後に続く子がないかどうかを示します。
	LevelDepth	Member を含むレベルの位置を示す序数を取得します。
	LevelName	Member を含むレベルの名前を取得します。
	MemberProperties	Member のメンバー プロパティのコレクションを含む MemberPropertyCollection を取得します。
	Name	Member の名前を取得します。
	Parent	Member を含む親 Member への参照を取得します (ある場合)。
	ParentLevel	このプロパティは、Member を含む Level を取得します。
	ParentSameAsPrevious	この位置メンバーの親がすぐ前のメンバーの親と同一であるかどうかを返します。
	Properties	Member に関連付けられたプロパティを含む PropertyCollection を取得します。
	Type	Member のメンバーの種類を取得します。
	UniqueName	Member の一意の名前を取得します。

先頭に戻る

メソッド

	名前	説明
	Equals	Member の 2 つのインスタンスが等しいかどうかを示します。 (Object.Equals(Object) をオーバーライドします。)
	FetchAllProperties	サーバーからすべてのメンバー プロパティを取得します。
	GetChildren()	Member の子メンバーのコレクションを含む MemberCollection を返します。
	GetChildren(Int64, Int64)	Member の子メンバーのコレクションを含む MemberCollection を返します。返されるオブジェクトは、count メンバーまでが含まれ、start により示される位置から始まります。
	GetChildren(Int64, Int64, array<MemberFilter[])	Member の子メンバーのコレクションを含む MemberCollection を返します。返されるオブジェクトは、count メンバーまでが含まれ、start パラメーターによって示された位置から始まり、filters パラメーターによってフィルター選択されます。
	GetChildren(Int64, Int64, array<String[], array<MemberFilter[])	Member の子メンバーのコレクションを含む MemberCollection を返します。返されるオブジェクトは、count メンバーまでが含まれ、start パラメーターによって示された位置から始まり、filters パラメーターによってフィルター選択されます。各メンバーは、properties パラメーターに渡される Array で示されたプロパティをキャッシュします。注   パフォーマンス上の理由により、このオーバーロードは、既定ではないメンバー プロパティが必要な場合にのみ使用してください。既定のメンバー プロパティには、Name、UniqueName、Caption、ChildCount、Description、LevelDepth、LevelName、Parent、ParentLevel、および Type が含まれます。
	GetHashCode	ハッシュ アルゴリズムや、ハッシュ テーブルなどのデータ構造で使用する、特定の種類のハッシュ関数として機能します。 (Object.GetHashCode() をオーバーライドします。)
	GetType	(Object から継承されています。)
	ToString	Member の名前を表す String です。 (Object.ToString() をオーバーライドします。)

先頭に戻る

演算子

	名前	説明
	Equality	Member の 2 つのインスタンスが等しいかどうかを示します。
	Inequality	Member の 2 つのインスタンスが等しいかどうかを示します。

先頭に戻る

説明

メンバーは、基になるリレーショナル データベース内の 1 つ以上のレコードを表す階層内の項目です。 メンバーは、キューブ内のセル データにアクセスする際に使用する最も低い参照レベルです。

メンバーは組を構成するために使用され、組はセットを構成するために使用されます。 メンバーは階層化されます。つまり、あるメンバーに関連付けられた他のメンバーが存在します。 たとえば、年、月、日という 3 つのレベルを含む時間ディメンションでは、日レベルのメンバーは子メンバーがないためリーフ メンバーです。 月レベルの各メンバーには少なくとも 28 の日レベルの子メンバーがあり、年レベルの各メンバーには 12 の月レベルの子メンバーがあるので、年および月レベルのメンバーは非リーフ メンバーです。

Member は、子メンバー (ある場合) を含む Member オブジェクトのコレクションを含め、メンバーの説明に必要な情報をカプセル化します。

Member が利用できる情報は、Member を取得した Members コレクションの親によって異なります。 Members コレクションは、外部的には、指定した Hierarchy、Tuple、Level、または Member の Member オブジェクトのコレクションを表し、内部的には、Hierarchy、Tuple、Level、または Member の親に応じて次の 2 とおりの方法のうちのいずれかで読み込まれ、管理されます。

• サーバーからメタデータを取得するため CubeDef を介して親オブジェクトが参照された場合、コレクションは親オブジェクトに定義されるメンバーを表します。

• クエリからメタデータを取得するため CellSet を介して親オブジェクトが参照された場合は、コレクションは親オブジェクトを含むセット (または軸) に対して取得されるメンバーを表します。

使用例

次のサブルーチンでは、Hierarchy を受け取り、Members コレクションの繰り返し処理を実行し、各 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

スレッド セーフ

この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

関連項目

参照

Microsoft.AnalysisServices.AdomdClient 名前空間