CellInfo 要素 (XMLA)

  • [アーティクル]

親要素 OlapInfo に含まれるセル メタデータを表します。

構文

<OlapInfo>
   ...
   <CellInfo>
      <!-- One or more cell property definitions -->
   </CellInfo>
   ...
</OlapInfo>

要素の特性

特性

説明

データ型と長さ

なし

既定値

なし

基数

1-1 : 必須要素で、1 回だけ出現します

要素のリレーションシップ

リレーションシップ

要素

親要素

OlapInfo

子要素

1 つ以上のセル プロパティ定義

説明

CellInfo 要素は、MDDataSet データ型を使用する root 要素によって返される多次元データセット内に含まれる、セルのプロパティのコレクションを含みます。 CellInfo 要素内のそれぞれのセル プロパティは別個の XML 要素によって定義され、それぞれに name 属性と type 属性が指定されています。 セル プロパティの name 属性は、XML 要素によって表される OLE DB for OLAP セル プロパティの名前に対応します。type 属性は、セル プロパティの XML データ型を表します。 XML 要素の名前は、root 要素の CellData 要素に含まれるセルのセル プロパティの値を識別するために使用されます。

セル プロパティ定義の構文は次のとおりです。

<CellPropertyDefinition name="string" type"string" />

使用可能なプロパティとその値は、Discover メソッドで要求の種類として DISCOVER_PROPERTIES を使用することによって取得できます。 PropertyList 要素内に一覧表示されるプロパティの順序は任意です。

オプションで、プロバイダーは AxisInfo または CellInfo セクション内の個々のメンバーまたはセル プロパティの既定値を指定できます。 プロパティの値が常に同じ、あるいはほとんど同じ場合、既定値を使用すると結果を小さくすることができます。 プロパティの既定値を示すには、いずれかのセル プロパティ定義要素の子要素として、オプションの Default 要素を指定できます。 したがって、結果の中にメンバーまたはセル プロパティが存在しない場合、指定された既定値がセル プロパティの値になります。

使用例

次の例は、CellInfo 要素内で、セル プロパティ VALUE、FORMATTED_VALUE、および FORMAT_STRING がどのように表されるかを示しています。

<OlapInfo>
   ...
      <CellInfo>
         <Value name="VALUE"></Value>
         <FmtValue name="FORMATTED_VALUE"></FmtValue>
         <FormatString name="FORMAT_STRING"></FormatString>
      </CellInfo>
</OlapInfo>

関連項目

概念

プロパティ (XMLA)