CallByName, fonction
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 |
---|---|---|
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
Notes du développeur sur Smart Device
Cette fonction n'est pas prise en charge.
Configuration requise
Espace de noms :Microsoft.VisualBasic
**Module :**Interaction
**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Voir aussi
Concepts
Appel d'une propriété ou méthode à l'aide d'un nom de chaîne