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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

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

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

Object

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

Excepciones

ArgumentException

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.

Consulte también

• CallType
• ArgumentException
• Matrices de parámetros
• Llamar a una propiedad o método mediante un nombre de cadena