Interaction.CallByName(Object, String, CallType, Object[]) メソッド

定義

オブジェクトに対してメソッドを実行するか、オブジェクトのプロパティを設定または取得します。Executes a method on an object, or sets or returns a property on an object.

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

パラメーター

ObjectRef
Object

必須。Required. [https://login.microsoftonline.com/consumers/](Object)Object. プロパティまたはメソッドを公開しているオブジェクトへのポインターです。A pointer to the object exposing the property or method.

ProcName
String

必須。Required. [https://login.microsoftonline.com/consumers/](String)String. オブジェクトのプロパティまたはメソッドの名前を含む文字列式です。A string expression containing the name of the property or method on the object.

UseCallType
CallType

必須。Required. 呼び出されるプロシージャの型を表す、CallType 型の列挙体のメンバーです。An enumeration member of type CallType representing the type of procedure being called. CallType の値は、MethodGetSet のいずれかになります。The value of CallType can be Method, Get, or Set.

Args
Object[]

省略可能。Optional. [https://login.microsoftonline.com/consumers/](ParamArray)ParamArray. 呼び出されるプロパティまたはメソッドに渡される引数を格納するパラメーター配列です。A parameter array containing the arguments to be passed to the property or method being called.

戻り値

Object

オブジェクトに対してメソッドを実行するか、オブジェクトのプロパティを設定または取得します。Executes a method on an object, or sets or returns a property on an object.

例外

UseCallType の値が無効です。MethodGet、または Set のいずれかを指定してください。Invalid UseCallType value; must be Method, Get, or Set.

次の例では、最初の行は CallByName を使用してテキストボックスの Text プロパティを設定し、2行目は Text プロパティの値を取得し、3番目の行は Move メソッドを呼び出してテキストボックスを移動します。In the following example, the first line uses CallByName to set the Text property of a text box, the second line retrieves the value of the Text property, and the third line invokes the Move method to move the text box.

' 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

次の例では、CallByName 関数を使用して、コレクションオブジェクトの Add メソッドと Item メソッドを呼び出します。The next example uses the CallByName function to invoke the Add and Item methods of a collection object.

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

注釈

CallByName 関数は、実行時にプロパティを取得したり、プロパティを設定したり、メソッドを呼び出したりするために使用されます。The CallByName function is used at runtime to get a property, set a property, or invoke a method.

適用対象

こちらもご覧ください