Interaction.CallByName, méthode

Article
08/21/2007

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

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function CallByName ( _
    ObjectRef As Object, _
    ProcName As String, _
    UseCallType As CallType, _
    ParamArray Args As Object() _
) As Object
'Utilisation
Dim ObjectRef As Object
Dim ProcName As String
Dim UseCallType As CallType
Dim Args As Object()
Dim returnValue As Object

returnValue = Interaction.CallByName(ObjectRef, ProcName, UseCallType, Args)

public static Object CallByName (
    Object ObjectRef,
    string ProcName,
    CallType UseCallType,
    params Object[] Args
)

public:
static Object^ CallByName (
    Object^ ObjectRef, 
    String^ ProcName, 
    CallType UseCallType, 
    ... array<Object^>^ Args
)

public static Object CallByName (
    Object ObjectRef, 
    String ProcName, 
    CallType UseCallType, 
    Object[] Args
)

public static function CallByName (
    ObjectRef : Object, 
    ProcName : String, 
    UseCallType : CallType, 
    ... Args : Object[]
) : Object

Paramètres

ObjectRef
Obligatoire. Object. Pointeur qui désigne l'objet exposant la propriété ou la méthode.

ProcName
Obligatoire. String. Expression de type chaîne contenant le nom de la propriété ou de la méthode sur l'objet.

UseCallType
Obligatoire. Membre de l'énumération de type CallType 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.

Valeur de retour

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

Notes

Pour plus d'informations, consultez la rubrique Visual Basic CallByName, fonction.

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 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

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0

Voir aussi

Référence

Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms
ArgumentException Class

Autres ressources

CallByName, fonction
CallType, énumération
Tableaux de paramètres
Appel d'une propriété ou méthode à l'aide d'un nom de chaîne

Partager via