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.Executes a method on an object, or sets or returns a property on an object.

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.Required. Object.Object. Puntero al objeto que expone la propiedad o el método.A pointer to the object exposing the property or method.

ProcName
String

Obligatorio.Required. String.String. Expresión de cadena que contiene el nombre de la propiedad o del método en el objeto.A string expression containing the name of the property or method on the object.

UseCallType
CallType

Obligatorio.Required. Miembro de enumeración de tipo CallType que representa el tipo de procedimiento al que se llama.An enumeration member of type CallType representing the type of procedure being called. El valor de CallType puede ser Method, Get o Set.The value of CallType can be Method, Get, or Set.

Args
Object[]

Opcional.Optional. ParamArray.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.A parameter array containing the arguments to be passed to the property or method being called.

Devoluciones

Ejecuta un método en un objeto, o bien establece o devuelve una propiedad en un objeto.Executes a method on an object, or sets or returns a property on an object.

Excepciones

Valor UseCallType no válido; debe ser Method, Get o Set.Invalid UseCallType value; must be Method, Get, or Set.

Ejemplos

En el ejemplo siguiente, la primera línea usa CallByName para establecer la propiedad Text de un cuadro de texto, la segunda línea recupera el valor de la propiedad Text y la tercera línea invoca el método Move para desplace el cuadro de texto.In the following example, the first line uses CallByName to set the Text property of a text box, the second line retrieves the value of the Text property, and the third line invokes the Move method to move the text box.

' 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 función CallByName para invocar los métodos Add y Item de un objeto de colección.The next example uses the CallByName function to invoke the Add and Item methods of a collection object.

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 función CallByName se utiliza en tiempo de ejecución para obtener una propiedad, establecer una propiedad o invocar un método.The CallByName function is used at runtime to get a property, set a property, or invoke a method.

Se aplica a

Consulte también: