Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Devolve um Valor Longo contendo o maior índice disponível para a dimensão indicada de um matriz.

Sintaxe

UBound ( arrayname [, dimensão ] )

A sintaxe da função UBound tem estes argumentos:

Argumento

Descrição

arrayname

Obrigatório. Nome da matriz variável; segue as convenções de nomenclatura de variáveis padrão.

dimensão

Opcional. Variante (Longo). Número inteiro que indica qual o limite superior da dimensão que é devolvido. Utilize 1 para a primeira dimensão, 2 para a segunda e assim sucessivamente. Se a dimensão for omitida, é assumido 1.

Observações

A função UBound é utilizada com a função LBound para determinar o tamanho de uma matriz. Utilize a função LBound para encontrar o limite inferior de uma dimensão de matriz.

UBound devolve os seguintes valores para uma matriz com estas dimensões:

Dim A(1 To 100, 0 To 3, -3 To 4)

Declaração

Valor Devolvido

UBound(A, 1)

100

UBound(A, 2)

3

UBound(A, 3)

4

Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função UBound para determinar o maior índice disponível para a dimensão indicada de uma matriz.

Dim Upper' Declare array variables.Dim MyArray(1 To 10, 5 To 15, 10 To 20)Dim AnyArray(10)Upper = UBound(MyArray, 1)    ' Returns 10.Upper = UBound(MyArray, 3)    ' Returns 20.Upper = UBound(AnyArray)    ' Returns 10.

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.