호출자 정보(Visual Basic)

호출자 정보 특성을 사용하여 메서드에 대한 호출자에 대한 정보를 가져올 수 있습니다. 소스 코드의 파일 경로, 소스 코드의 줄 번호 및 호출자의 멤버 이름을 가져올 수 있습니다. 이 정보는 진단 도구를 추적, 디버깅 및 만드는 데 유용합니다.

이 정보를 얻으려면 각각 기본값이 있는 선택적 매개 변수에 적용되는 특성을 사용합니다. 다음 표에서는 네임스페이스에 System.Runtime.CompilerServices 정의된 호출자 정보 특성을 나열합니다.

예시

다음 예제에서는 호출자 정보 특성을 사용하는 방법을 보여 줍니다. 메서드에 대한 TraceMessage 각 호출에서 호출자 정보는 선택적 매개 변수의 인수로 대체됩니다.

Private Sub DoProcessing()  
    TraceMessage("Something happened.")  
End Sub  
  
Public Sub TraceMessage(message As String,  
        <System.Runtime.CompilerServices.CallerMemberName> Optional memberName As String = Nothing,  
        <System.Runtime.CompilerServices.CallerFilePath> Optional sourcefilePath As String = Nothing,  
        <System.Runtime.CompilerServices.CallerLineNumber()> Optional sourceLineNumber As Integer = 0)  
  
    System.Diagnostics.Trace.WriteLine("message: " & message)  
    System.Diagnostics.Trace.WriteLine("member name: " & memberName)  
    System.Diagnostics.Trace.WriteLine("source file path: " & sourcefilePath)  
    System.Diagnostics.Trace.WriteLine("source line number: " & sourceLineNumber)  
End Sub  
  
' Sample output:  
'   message: Something happened.  
'   member name: DoProcessing  
'   source file path: C:\Users\username\Documents\Visual Studio 2012\Projects\CallerInfoVB\CallerInfoVB\Form1.vb  
'   source line number: 15  

비고

각 선택적 매개 변수에 대해 명시적 기본값을 지정해야 합니다. 선택 사항으로 지정되지 않은 매개 변수에 호출자 정보 특성을 적용할 수 없습니다.

호출자 정보 특성은 매개 변수를 선택적으로 만들지 않습니다. 대신 인수를 생략할 때 전달되는 기본값에 영향을 미칩니다.

호출자 정보 값은 컴파일 시간에 IL(Intermediate Language)에 리터럴로 내보내집니다. 예외에 대한 속성의 StackTrace 결과와 달리 결과는 난독 처리의 영향을 받지 않습니다.

선택적 인수를 명시적으로 제공하여 호출자 정보를 제어하거나 호출자 정보를 숨길 수 있습니다.

멤버 이름

이 특성을 사용하여 CallerMemberName 멤버 이름을 호출된 메서드의 인수로 String 지정하지 않도록 할 수 있습니다. 이 기술을 사용하면 리팩터링 이름 바꾸기 가 값을 변경하지 않는 문제를 방지할 수 String 있습니다. 이 혜택은 다음 작업에 특히 유용합니다.

• 추적 및 진단 루틴 사용.

• 데이터를 바인딩할 때 INotifyPropertyChanged 인터페이스를 구현. 이 인터페이스를 사용하면 개체의 속성이 변경되었음을 바인딩된 컨트롤에 알릴 수 있으므로 컨트롤이 업데이트된 정보를 표시할 수 있습니다. 특성이 CallerMemberName 없으면 속성 이름을 리터럴로 지정해야 합니다.

다음 차트는 특성을 사용할 CallerMemberName 때 반환되는 멤버 이름을 보여줍니다.

호출자 표현식

System.Runtime.CompilerServices.CallerArgumentExpressionAttribute를 사용하여 인수에 사용된 식을 캡처하려는 경우입니다. 진단 라이브러리는 인수로 전달된 식 에 대한 자세한 정보를 제공할 수 있습니다. 개발자는 매개 변수 이름 외에도 진단을 트리거한 식을 제공하여 진단을 트리거한 조건에 대한 자세한 정보를 제공합니다. 이 추가 정보를 사용하면 쉽게 해결할 수 있습니다. 다음 메서드는 다음 CallerArgumentExpressionAttribute 을 사용하여 다음과 같은 조건을 표시합니다 True.

Public Shared Sub ValidateArgument(ByVal parameterName As String,
ByVal condition As Boolean,
<CallerArgumentExpression("condition")> ByVal Optional message As String? = Nothing)
    If Not condition Then
        Throw New ArgumentException($"Argument failed validation: <{message}>", parameterName)
    End If
End Sub

참고하십시오

• 특성(Visual Basic)
• 공통 특성(Visual Basic)
• 선택적 매개 변수
• 프로그래밍 개념(Visual Basic)