Artigo
04/01/2012

Elemento CellInfo (XMLA)

Representa os metadados de célula contidos pelo elemento pai OlapInfo.

Sintaxe

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

Características do elemento

Característica	Descrição
Tipo e comprimento dos dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	1-1: elemento obrigatório que ocorre apenas uma única vez.

Relação do elemento

Relação	Elemento
Elementos pai	OlapInfo
Elementos filho	Uma ou mais definições de propriedade de célula

Comentários

O elemento CellInfo contém uma coleção de propriedades de célula para as células incluídas no conjunto de dados multidimensionais retornado por um elemento root usando o tipo de dados MDDataSet. Cada propriedade de célula no elemento CellInfo é definida por um elemento XML separado, cada um com um atributo name e um atributo type. O atributo name da propriedade de célula corresponde ao nome do comando OLE DB para a propriedade de célula OLAP representada pelo elemento XML e o atributo type representa o tipo de dados XML da propriedade de célula. O nome do elemento XML é usado para identificar o valor da propriedade de célula para as células contidas no elemento CellData do elemento root.

A sintaxe a seguir descreve uma definição de propriedade de célula:

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

As propriedades disponíveis e seus valores podem ser obtidos usando o tipo de solicitação DISCOVER_PROPERTIES com o método Discover. Não há nenhum pedido obrigatório para as propriedades listadas no elemento PropertyList.

Um provedor pode especificar valores padrão opcionalmente para propriedades de célula ou membros individuais na seção AxisInfo ou CellInfo. Os valores padrão podem fornecer um resultado menor se a propriedade sempre ou quase sempre tiver o mesmo valor. Para indicar um valor padrão para uma propriedade, o elementoDefault pode ser especificado opcionalmente como um elemento filho de um dos elementos de definição de propriedade de célula. Portanto, a ausência de um membro ou propriedade de célula no resultado indica que o padrão declarado é o valor da propriedade de célula.

Exemplo

O exemplo a seguir demonstra como as propriedades de célula VALUE, FORMATTED_VALUE e FORMAT_STRING são representadas no elemento CellInfo.

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

Consulte também

Conceitos

Função Properties (XMLA)

Compartilhar via