CellInfo 要素 (XMLA)

  • [アーティクル]

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

構文

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

要素の特性

特徴 説明
データ型と長さ なし
既定値 なし
カーディナリティ 1-1 : 必須要素で、1 回だけ出現します

要素の関係

リレーションシップ 要素
親要素 OlapInfo
子要素 1 つ以上のセル プロパティ定義

注釈

Cellinfo要素には、 mddatasetデータ型を使用してルート要素によって返される多次元データセット内に含まれるセルのセルプロパティのコレクションが含まれています。 Cellinfo要素の各セルプロパティは、 name属性とtype属性を持つ個別の XML 要素によって定義されます。 Cell プロパティの name 属性は、xml 要素によって表される OLAP セルプロパティの OLE DB の名前に対応し、 type 属性は cell プロパティの XML データ型を表します。 XML 要素の名前は、ルート要素のcelldata要素に含まれるセルのセルプロパティの値を識別するために使用されます。

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

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

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

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

例

次の例では、値、FORMATTED_VALUE、FORMAT_STRING セルプロパティが、 Cellinfo 要素でどのように表されるかを示します。

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