Função CallByName

Artigo
08/25/2010

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