Compartilhar via


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

Definição

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);
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

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

Exceções

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.

Aplica-se a

Confira também