Compartilhar via


Função CallByName

Executa um método em um objeto, ou define ou retorna uma propriedade em um objeto.

Public Function CallByName( _
   ByVal ObjectRef As System.Object, _
   ByVal ProcName As String, _
   ByVal UseCallType As CallType, _
   ByVal Args() As Object _
) As Object

Parâmetros

  • ObjectRef
    Obrigatório.Object.Um ponteiro para o objeto expondo a propriedade ou método.

  • ProcName
    Obrigatório.String.Uma expressão em seqüência que contém o nome da propriedade ou método no objeto.

  • UseCallType
    Obrigatório.Um membro de enumeração do tipo Enumeração CallType que representa o tipo de procedimento sendo chamado.O valor de CallType pode ser Method, Get, ou Set.

  • Args
    Opcional.ParamArray.Uma matriz de parâmetro que contém os argumentos a serem passados para a propriedade ou método sendo chamado.

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

Valor UseCallType valor; deve ser Method, Get, ou Set.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A função CallByName é usada em tempo de execução para obter uma propriedade, definir uma propriedade ou chamar um método.

Exemplo

No exemplo a seguir, a primeira linha usa CallByName para definir a propriedade Text de um caixa de texto, a segunda linha recupera o valor da propriedade Text, e a terceira linha chama o método Move para mover a caixa de texto.

' Imports statements must be at the top of a module.
Imports Microsoft.VisualBasic.CallType
Sub TestCallByName1()
    'Set a property.
    CallByName(TextBox1, "Text", CallType.Set, "New Text")

    'Retrieve the value of a property.
    MsgBox(CallByName(TextBox1, "Text", CallType.Get))

    'Call a method.
    CallByName(TextBox1, "Hide", CallType.Method)
End Sub

O exemplo a seguir usa a função CallByName para chamar os métodos Add e Itemde um objeto de coleção.

Public Sub TestCallByName2()
    Dim col As New Collection()

    'Store the string "Item One" in a collection by 
    'calling the Add method.
    CallByName(col, "Add", CallType.Method, "Item One")

    'Retrieve the first entry from the collection using the 
    'Item property and display it using MsgBox().
    MsgBox(CallByName(col, "Item", CallType.Get, 1))
End Sub

Anotações Developer Dispositivo Inteligente

Não há suporte para esta função.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**Interaction

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Conceitos

Matrizes de parâmetro

Chamando uma propriedade ou método usando um nome de sequência de caracteres

Referência

Enumeração CallType

ArgumentException