CallByName 함수

업데이트: 2007년 11월

개체의 메서드를 실행하거나 개체의 속성을 설정 또는 반환합니다.

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

매개 변수

  • ObjectRef
    필수적 요소. Object. 속성이나 메서드를 노출하는 개체에 대한 포인터입니다.

  • ProcName
    필수적 요소. String. 개체의 속성이나 메서드 이름을 포함하고 있는 문자열 식입니다.

  • UseCallType
    필수적 요소. 호출되는 프로시저의 형식을 나타내는 CallType 열거형 형식의 열거형 멤버입니다. CallType 값은 Method, Get 또는 Set이 될 수 있습니다.

  • Args
    선택적 요소. ParamArray. 호출되는 속성이나 메서드에 전달될 인수가 포함된 매개 변수 배열입니다.

예외

예외 형식

오류 번호

조건

ArgumentException

5

UseCallType 값이 잘못되었습니다. Method, Get 또는 Set이어야 합니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

CallByName 함수는 런타임에 속성을 가져오거나 속성을 설정하거나 메서드를 호출하는 데 사용됩니다.

예제

다음 예제에서 첫째 줄은 CallByName을 사용하여 텍스트 상자의 Text 속성을 설정하고, 둘째 줄은 Text 속성의 값을 검색하며, 셋째 줄은 Move 메서드를 호출하여 입력란을 이동합니다.

' 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 메서드를 호출합니다.

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

스마트 장치 개발자 참고 사항

이 함수는 지원되지 않습니다.

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Interaction

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

개념

매개 변수 배열

문자열 이름을 사용하여 속성 또는 메서드 호출

참조

CallType 열거형

ArgumentException