Interaction.CallByName(Object, String, CallType, Object[]) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Executa um método num objeto, ou define ou devolve uma propriedade num objeto.

public:
 static System::Object ^ CallByName(System::Object ^ ObjectRef, System::String ^ ProcName, Microsoft::VisualBasic::CallType UseCallType, ... cli::array <System::Object ^> ^ Args);
public static object CallByName(object ObjectRef, string ProcName, Microsoft.VisualBasic.CallType UseCallType, params object[] Args);
static member CallByName : obj * string * Microsoft.VisualBasic.CallType * obj[] -> obj
Public Function CallByName (ObjectRef As Object, ProcName As String, UseCallType As CallType, ParamArray Args As Object()) As Object

Parâmetros

ObjectRef
Object

Required. Object. Um apontador para o objeto que expõe a propriedade ou método.

ProcName
String

Required. String. Uma expressão de cadeia que contém o nome da propriedade ou método no objeto.

UseCallType
CallType

Required. Um membro de enumeração do tipo CallType que representa o tipo de procedimento a ser chamado. O valor de CallType pode ser Method, Get, ou Set.

Args
Object[]

Optional. ParamArray. Um array de parâmetros contendo os argumentos a serem passados para a propriedade ou método que está a ser chamado.

Devoluções

Object

Executa um método num objeto, ou define ou devolve uma propriedade num objeto.

Exceções

ArgumentException

Valor inválido UseCallType ; deve ser Method, Get, ou Set.

Exemplos

No exemplo seguinte, a primeira linha usa CallByName para definir a Text propriedade de uma caixa de texto, a segunda linha recupera o valor da Text propriedade e a terceira linha invoca o Move método 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 seguinte usa a CallByName função para invocar os Add métodos e Item de 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

Observações

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

Aplica-se a

Ver também