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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Interaction.vb

Executa um método em um objeto ou define ou retorna uma propriedade em um 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

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

ProcName

String

Obrigatórios. String. Uma expressão de cadeia de caracteres que contém o nome da propriedade ou método no objeto.

UseCallType

CallType

Obrigatórios. Um membro de enumeração do tipo CallType representando o tipo de procedimento sendo chamado. O valor de CallType pode ser Method, Get ou Set.

Args

Object[]

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

Retornos

Object

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

Exceções

ArgumentException

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

Exemplos

No exemplo a seguir, 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 a seguir 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

Comentários

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

Confira também

• CallType
• ArgumentException
• Matrizes de Parâmetros
• Chamando uma propriedade ou um método usando o nome de uma cadeia de caracteres