Artikel
09/24/2010

CellInfo-Element (XMLA)

Stellt die Zellmetadaten dar, die das übergeordnete OlapInfo-Element enthält.

Syntax

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

Elementmerkmale

Merkmal	Beschreibung
Datentyp und -länge	Keine
Standardwert	Kein
Kardinalität	1-1: Erforderliches Element, das nur einmal auftritt.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	OlapInfo
Untergeordnete Elemente	Eine oder mehrere Definitionen der Zelleneigenschaften

Hinweise

Das CellInfo-Element enthält eine Auflistung der Zelleneigenschaften der Zellen, die in dem multidimensionalen Datensatz, der von einem root-Element mithilfe des MDDataSet-Datentyps zurückgegeben wird, enthalten sind. Jede Zelleneigenschaft in dem CellInfo-Element wird durch ein einzelnes XML-Element definiert, das jeweils ein name-Attribut und ein type-Attribut enthält. Das name-Attribut der Zelleneigenschaft entspricht dem Namen der OLE DB für die OLAP-Zelleneigenschaft, die durch das XML-Element dargestellt wird; das type-Attribut stellt den XML-Datentyp der Zelleneigenschaft dar. Der Name des XML-Elements wird verwendet, um den Wert der Zelleneigenschaft der Zellen zu identifizieren, die in dem CellData-Element des root-Elements enthalten sind.

Die folgende Syntax beschreibt die Definition einer Zelleneigenschaft:

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

Die benötigten Eigenschaften und ihre Werte können über eine Nutzung des Anforderungstyps DISCOVER_PROPERTIES mit der Discover-Methode abgerufen werden. Es gibt keine erforderliche Reihenfolge für die im PropertyList-Element aufgelisteten Eigenschaften.

Optional können Anbieter Standardwerte für einzelne Elemente oder Zelleneigenschaften im AxisInfo- oder CellInfo-Abschnitt angeben. Die Standardwerte können für eine kleinere Ergebnismenge sorgen, wenn die Eigenschaft immer oder fast immer den gleichen Wert hat. Zum Angeben eines Standardwerts für eine Eigenschaft kann das Default-Element optional als untergeordnetes Element von einem der Zelleneigenschaften-Definitionselemente angegeben werden. Das Fehlen eines Elements oder einer Zelleneigenschaft im Ergebnis deutet daher darauf hin, dass der angegebene Standardwert der Wert der Zelleneigenschaft ist.

Beispiel

Das folgende Beispiel zeigt daher, wie die Zelleneigenschaften VALUE, FORMATTED_VALUE und FORMAT_STRING im CellInfo-Element dargestellt werden.

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

Siehe auch

Konzepte

Eigenschaften (XMLA)

Freigeben über