Função TypeName

Aplica-se a
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

Retorna uma Cadeia de Caracteres que fornece informações sobre uma variável.

Sintaxe

TypeName(varname)

O argumento varnamenecessário é uma Variant que contém qualquer variável, exceto uma variável de um tipo definido pelo usuário.

Comentários

A cadeia de caracteres retornada pelo TypeName pode ser qualquer uma das seguintes:

Cadeia de caracteres retornada Variável
Tipo de objeto Um objeto cujo tipo é objecttype
Byte Valor byte
Inteiro Inteiro
Longas Inteiro longo
Simples Número de ponto flutuante de precisão única
Duplo Número de ponto flutuante de precisão dupla
Moeda Valor da moeda
Decimal Valor decimal
Data Valor da data
Cadeia de caracteres Cadeia de caracteres
Booliano Valor booliano
Erro Um valor de erro
Vazio Inicializado
Nulo Sem dados válidos
Objeto Um objeto
Desconhecido Um objeto cujo tipo é desconhecido
Nada Variável de objeto que não se refere a um objeto

    

Se varname for uma matriz, a cadeia de caracteres retornada poderá ser qualquer uma das cadeias de caracteres retornadas possíveis (ou Variant) com parênteses vazios acrescentados. Por exemplo, se varname for uma matriz de inteiros, TypeName retornará "Integer()".

Exemplo

Observação

Exemplos a seguir demonstram o uso dessa 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.

Este exemplo usa a função TypeName para retornar informações sobre uma variável.

Dim NullVar, MyType, StrVar As String
Dim IntVar As Integer, CurVar As Currency
Dim ArrayVar (1 To 5) As Integer
NullVar = Null    ' Assign Null value.
MyType = TypeName(StrVar)     ' Returns "String".
MyType = TypeName(IntVar)     ' Returns "Integer".
MyType = TypeName(CurVar)     ' Returns "Currency".
MyType = TypeName(NullVar)    ' Returns "Null".
MyType = TypeName(ArrayVar)   ' Returns "Integer()".