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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

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

ProcName
String

Required. String. Uma expressão de cadeia de caracteres 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 que está sendo chamado. O valor de CallType pode ser Method, Getou Set.

Args
Object[]

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

Retornos

Object

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

Exceções

ArgumentException

Valor inválido UseCallType ; deve ser Method, Getou 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 métodos e Item os Add métodos 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.

Aplica-se a

Confira também