CallByName, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Applique une méthode à un objet, ou définit ou retourne une propriété d'un objet.

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

Paramètres

ObjectRef
Requis. Object. Pointeur qui désigne l'objet exposant la propriété ou la méthode.
ProcName
Requis. String. Expression de type chaîne contenant le nom de la propriété ou de la méthode sur l'objet.
UseCallType
Requis. Membre de l'énumération de type CallType, énumération représentant le type de la procédure appelée. La valeur de CallType peut être Method, Get ou Set.
Args
Facultatif. ParamArray. Tableau de paramètres contenant les arguments à passer à la propriété ou la méthode appelée.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Valeur UseCallType non valide ; doit être Method, Get ou Set.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La fonction CallByName est utilisée lors de l'exécution pour obtenir une propriété, définir une propriété ou appeler une méthode.

Exemple

Dans l'exemple suivant, la première ligne utilise CallByName pour définir la propriété Text d'une zone de texte, la deuxième ligne récupère la valeur de la propriété Text et la troisième ligne appelle la méthode Move pour déplacer la zone de texte.

' 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

L'exemple suivant utilise la fonction CallByName pour appeler les méthodes Add et Item d'un objet de 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