Propriedade Item (conjunto de células do ADO MD)

Recupera uma célula de um conjunto de células usando suas coordenadas.

Sintaxe

  
Set  
Cell = Cellset.Item ( Positions)  

Parâmetros

Posições
Um VariantArray de valores que especificam exclusivamente uma célula. Positions pode ser um dos seguintes:

  • Uma matriz de números de posição

  • Uma matriz de nomes de membros

  • A posição ordinal

Comentários

Use a propriedade Item para retornar um objeto Cell dentro de um objeto Cellset. Se a propriedade Item não puder localizar a célula correspondente ao argumento Positions, ocorrerá um erro.

A propriedade Item é a propriedade padrão para o objeto Cellset. Os seguintes formulários de sintaxe são intercambiáveis:

  
Cellset.Item ( Positions )Cellset ( Positions )  

O argumento Positions especifica qual célula retornar. Você pode especificar a célula pela posição ordinal ou pela posição ao longo de cada eixo. Ao especificar a célula por posição ao longo de cada eixo, você pode especificar o valor numérico da posição ou os nomes dos membros para cada posição.

A posição ordinal é um número que identifica exclusivamente uma célula dentro do Cellset. Conceitualmente, as células são numeradas em um Cellset como se o Cellset fosse uma matriz dimensional p, em que p é o número de eixos. As células são tratadas em ordem linha-principal. A seguir, está a fórmula para calcular o número ordinal de uma célula:

Se os nomes de membros forem passados como cadeias de caracteres para Item, os membros deverão ser listados em ordem crescente dos identificadores do eixo numérico. Dentro de um eixo, os membros devem ser listados em ordem crescente de aninhamento de dimensão – ou seja, o membro da dimensão mais externa vem primeiro, seguido por membros de dimensões internas. Cada dimensão deve ser representada por uma cadeia de caracteres separada, e a lista de cadeias de caracteres de membros deve ser separada por vírgulas.

Observação

A recuperação de células pelo nome do membro pode não ter suporte do provedor de dados. Consulte a documentação do provedor para obter mais informações.

Aplica-se A

Objeto Cellset (ADO MD)

Consulte Também

Objeto Cell (ADO MD)
Objeto Cellset (ADO MD)