Share via


Elemento CellInfo (XMLA)

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

Syntax

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

Características do elemento

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

Relações de 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 multidimensional retornado por um elemento raiz 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 de nome e um atributo de tipo. O atributo name da propriedade de célula corresponde ao nome do OLE DB para a propriedade de célula OLAP representada pelo elemento XML e o atributo de tipo representa o tipo de dados XML da propriedade da célula. O nome do elemento XML é usado para identificar o valor da propriedade de célula para células contidas no elemento CellData do elemento raiz.

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 .

Opcionalmente, um provedor pode especificar valores padrão para propriedades individuais de membro ou célula 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 opcionalmente ser especificado como um elemento filho de um dos elementos de definição de propriedade da 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 value, FORMATTED_VALUE e FORMAT_STRING célula são representadas no elemento CellInfo .

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