Devolve a 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 não especificar quaisquer argumentos, o Access cria 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 para o 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.
Nota
Os exemplos que se seguem mostram como utilizar esta função num módulo Visual Basic for Applications (VBA). 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 pelo Option Base.
Nota
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. A 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 utiliza a Array função para devolver a 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".