Retorna um Variant que contém uma matriz.
Sintaxe
Array(arglist)
O argumento necessário arglist é uma lista delimitada por vírgulas de valores atribuídos aos elementos da matriz no Variant. Se você não especificar nenhum argumento, o Access criará uma matriz de comprimento zero.
Comentários
Para se referir a um elemento em uma matriz, use o nome da variável seguido por parênteses que contêm o número de índice do elemento desejado. No exemplo a seguir, a primeira instrução cria uma variável chamada A como Variant. A segunda instrução atribui uma matriz a A. A última instrução atribui o valor no segundo elemento de matriz a outra variável.
Observação
Os exemplos a seguir mostram como usar essa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Dim A As Variant
A = Array(10,20,30)
B = A(2)
O limite inferior de uma matriz criada pela Array função é determinado pelo limite inferior especificado com a Option Base instrução, a menos que Array seja qualificado com o nome da biblioteca de tipos, como VBA.Array. Se você qualificá-lo com o nome da biblioteca de tipos, Array não será afetado por Option Base.
Observação
Um Variant que não é declarado como uma matriz ainda pode conter uma matriz. Uma Variant variável pode conter uma matriz de qualquer tipo, exceto cadeias de caracteres de comprimento fixo e tipos definidos pelo usuário. Um Variant que contém uma matriz é conceitualmente diferente de uma matriz cujos elementos são do tipo Variant, mas você acessa os elementos da matriz da mesma maneira.
Exemplo
Este exemplo usa a Array função para retornar uma Variant que contém uma matriz.
Dim MyWeek, MyDay
MyWeek = Array("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
' Return values assume the lower bound is set to 1 by using the
' Option Base statement.
MyDay = MyWeek(2) ' MyDay contains "Tue".
MyDay = MyWeek(4) ' MyDay contains "Thu".