Interaction.CallByName(Object, String, CallType, Object[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.