Funzione CallByName

Articolo
09/12/2008

Aggiornamento: novembre 2007

Esegue un metodo per un oggetto oppure imposta o restituisce una proprietà per un oggetto.

Public Function CallByName( _
   ByVal ObjectRef As System.Object, _
   ByVal ProcName As String, _
   ByVal UseCallType As CallType, _
   ByVal Args() As Object _
) As Object

Parametri

ObjectRef
Obbligatorio. Object. Puntatore dell'oggetto che espone la proprietà o il metodo.
ProcName
Obbligatorio. String. Espressione stringa contenente il nome della proprietà o del metodo per l'oggetto.
UseCallType
Obbligatorio. Membro di enumerazione di tipo Enumerazione CallType che rappresenta il tipo di routine che si sta chiamando. Il valore di CallType può essere Method, Get o Set.
Args
Facoltativo. ParamArray. Matrice di parametri contenente gli argomenti da passare alla proprietà o al metodo che si sta chiamando.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Valore UseCallType non valido. Deve essere Method, Get o Set.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La funzione CallByName viene utilizzata in fase di esecuzione per ottenere e impostare una proprietà o richiamare un metodo.

Esempio

Nella prima riga dell'esempio riportato di seguito la funzione CallByName viene utilizzata per impostare la proprietà Text per una casella di testo, nella seconda riga viene recuperato il valore della proprietà Text e nella terza viene richiamato metodo Move per spostare la casella di testo.

' 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

Nell'esempio riportato di seguito la funzione CallByName viene utilizzata per richiamare i metodi Add e Item di un oggetto Collection.

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