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

Definición

Ejecuta un método en un objeto, o bien establece o devuelve una propiedad en un 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

Obligatorio. Object. Puntero al objeto que expone la propiedad o el método.

ProcName
String

Obligatorio. String. Expresión de cadena que contiene el nombre de la propiedad o del método en el objeto.

UseCallType
CallType

Obligatorio. Miembro de enumeración de tipo CallType que representa el tipo de procedimiento al que se llama. El valor de CallType puede ser Method, Get o Set.

Args
Object[]

Opcional. ParamArray. Matriz de parámetros que contiene los argumentos que se van a pasar a la propiedad o al método al que se llama.

Devoluciones

Ejecuta un método en un objeto, o bien establece o devuelve una propiedad en un objeto.

Excepciones

Valor UseCallType no válido; debe ser Method, Get o Set.

Ejemplos

En el ejemplo siguiente, la primera línea usa CallByName para establecer la Text propiedad de un cuadro de texto, la segunda línea recupera el valor de la Text propiedad y la tercera línea invoca el Move método para mover el cuadro 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

En el ejemplo siguiente se usa la CallByName función para invocar los Add métodos y Item de un objeto de colección.

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

Comentarios

La CallByName función se usa en tiempo de ejecución para obtener una propiedad, establecer una propiedad o invocar un método.

Se aplica a

Consulte también