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 |
---|---|---|
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
Chamando uma propriedade ou método usando um nome de sequência de caracteres