Função IsObject

  • Artigo

Retorna um valor booliano que indica se um identificador representa uma variável de objeto.

Sintaxe

IsObject(identificador)

O argumentoidentificador necessário é um nome de variável.

Comentários

IsObject é útil apenas para determinar se uma Variant é de VarType vbObject. Isso pode ocorrer se a Variant realmente referenciar (ou uma vez referenciada) um objeto ou se ele contiver Nothing.

IsObject retorna True se o identificador for uma variável declarada com tipo de objeto ou qualquer tipo de classe válido, ou se o identificador for uma Variante do VarType vbObject ou um objeto definido pelo usuário; caso contrário, ele retorna False.

IsObject retorna True mesmo que a variável tenha sido definida como Nothing. Use a captura de erro para ter certeza de que uma referência de objeto é válida.

Observação

Essa função é útil no tratamento de erros de seções do código em que você não tem certeza se um objeto foi instanciado antes do erro ocorrer e, por exemplo, você deseja fechá-lo.

Exemplo

Este exemplo usa a função IsObject para determinar se um identificador representa uma variável de objeto. MyObject e YourObject são variáveis de objeto do mesmo tipo. São nomes genéricos usados apenas para fins de ilustração.

Dim MyInt As Integer              ' Declare variables.
Dim YourObject, MyCheck           ' Note: Default variable type is Variant.
Dim MyObject As Object
Set YourObject = MyObject         ' Assign an object reference.
MyCheck = IsObject(YourObject)    ' Returns True.
MyCheck = IsObject(MyInt)         ' Returns False.
MyCheck = IsObject(Nothing)       ' Returns True.
MyCheck = IsObject(Empty)         ' Returns False.
MyCheck = IsObject(Null)          ' Returns False.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.