연습: Visual Basic에서 시각화 도우미 작성

아티클
05/08/2023

Important

Visual Studio 2022 버전 17.9부터 새로운 VisualStudio.Extensibility 모델을 사용하여 프로세스 외부에서 실행되는 .NET 6.0 이상에서 비주얼라이저를 작성할 수 있습니다. 비주얼라이저 작성자는 이전 버전의 Visual Studio를 지원하거나 사용자 지정 비주얼라이저를 라이브러리 DLL의 일부로 제공하려는 경우가 아니라면 Visual Studio 디버거 비주얼라이저 만들기에서 제공되는 새 설명서를 참조하는 것이 좋습니다.

이 연습에서는 Visual Basic을 사용하여 간단한 시각화 도우미를 작성하는 방법을 보여줍니다. 이 연습에서 만들 시각화 도우미는 Windows Forms 메시지 상자를 사용하여 문자열의 내용을 표시합니다. 이 간단한 문자열 시각화 도우미는 프로젝트에 더 유용하게 사용할 수 있는 다른 형식에 대한 시각화 도우미를 만드는 방법을 보여 주는 기본 예시입니다.

참고 항목

표시되는 대화 상자와 메뉴 명령은 실제 설정이나 버전에 따라 도움말에서 설명하는 것과 다를 수 있습니다. 설정을 변경하려면 도구 메뉴로 이동하여 가져오기 및 내보내기를 선택합니다. 자세한 내용은 재설정 설정을 참조하세요.

시각화 도우미 코드는 디버거에서 읽을 DLL에 배치해야 합니다. 따라서 가장 먼저 할 일은 DLL의 클래스 라이브러리 프로젝트를 만드는 것입니다.

클래스 라이브러리 프로젝트 만들기 및 준비

클래스 라이브러리 프로젝트를 만들려면

새 클래스 라이브러리 프로젝트를 만듭니다.

Esc 키를 눌러 시작 창을 닫습니다. Ctrl + Q를 입력하여 검색 상자를 열고 visual basic을 입력한 다음 템플릿, 새 클래스 라이브러리 만들기(.NET Framework)를 차례로 선택합니다. 표시되는 대화 상자에서 만들기를 선택합니다.
클래스 라이브러리의 적절한 이름(예: MyFirstVisualizer)을 입력한 다음 만들기 또는 확인을 클릭합니다.

클래스 라이브러리를 만든 후에는 Microsoft.VisualStudio.DebuggerVisualizers.DLL에 대한 참조를 추가하여 여기에서 정의한 클래스를 사용할 수 있도록 해야 합니다. 그 전에 프로젝트에 의미 있는 이름을 부여해야 합니다.

Class1.vb의 이름을 바꾸고 Microsoft.VisualStudio.DebuggerVisualizers를 추가하려면

솔루션 탐색기에서 Class1.vb를 마우스 오른쪽 단추로 클릭하고, 바로 가기 메뉴에서 이름 바꾸기를 클릭합니다.
이름을 Class1.vb에서 DebuggerSide.vb 같은 의미 있는 이름으로 변경합니다.

참고 항목

Visual Studio에서 새 파일 이름과 일치하도록 DebuggerSide.vb의 클래스 선언이 자동으로 변경됩니다.
솔루션 탐색기에서 내 첫 번째 시각화 도우미를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 참조 추가를 클릭합니다.
참조 추가 대화 상자의 찾아보기 탭에서 찾아보기를 선택하고 Microsoft.VisualStudio.DebuggerVisualizers.DLL을 찾습니다.

Visual Studio 설치 디렉터리의 <Visual Studio Install Directory>\Common7\IDE\PublicAssemblies 하위 디렉터리에서 DLL을 찾을 수 있습니다.
확인을 클릭합니다.
DebuggerSide.vb에서 다음 문을 Imports 문에 추가합니다.
```
Imports Microsoft.VisualStudio.DebuggerVisualizers
```

디버거 쪽 코드 추가

이제 디버거 쪽 코드를 만들 준비가 되었습니다. 이는 시각화하려는 정보를 표시하기 위해 디버거 내에서 실행되는 코드입니다. 먼저 DebuggerSide 개체의 선언을 변경하여 DialogDebuggerVisualizer 기본 클래스에서 상속하도록 해야 합니다.

DialogDebuggerVisualizer에서 상속하려면

DebuggerSide.vb에서 다음 코드 줄로 이동합니다.
```
Public Class DebuggerSide
```
코드를 다음과 같이 편집합니다.
```
Public Class DebuggerSide
Inherits DialogDebuggerVisualizer
```
참고 항목

DialogDebuggerVisualizer는 생성자에 FormatterPolicy 인수가 필요합니다. 그러나 Visual Studio 2022 버전 17.11부터 .NET 5.0+에 대한 디버거쪽 특별 고려 사항에 설명된 보안 문제로 인해 비주얼라이저에서 Legacy 포맷터 정책을 지정할 수 없습니다.

DialogDebuggerVisualizer에는 재정의해야 할 한 가지 추상 메서드 Show가 있습니다.

DialogDebuggerVisualizer.Show 메서드를 재정의하려면

public class DebuggerSide에서 다음 메서드를 추가합니다.
```
Protected Overrides Sub Show(ByVal windowService As Microsoft.VisualStudio.DebuggerVisualizers.IDialogVisualizerService, ByVal objectProvider As Microsoft.VisualStudio.DebuggerVisualizers.IVisualizerObjectProvider)

    End Sub
```
Show 메서드에는 시각화 도우미 대화 상자나 기타 사용자 인터페이스를 실제로 만들고 디버거에서 시각화 도우미로 전달된 정보를 표시하는 코드가 들어 있습니다. 대화 상자를 만들고 정보를 표시하는 코드를 추가해야 합니다. 이 연습에서는 Windows Forms 메시지 상자를 사용하여 이 작업을 수행합니다. 먼저 Imports에 대한 참조와 System.Windows.Forms 문을 추가해야 합니다.

System.Windows.Forms을 추가하려면

솔루션 탐색기에서 참조를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 참조 추가를 클릭합니다.
참조 추가 대화 상자의 찾아보기 탭에서 찾아보기를 선택하고, System.Windows.Forms.DLL을 찾습니다.

C:\Windows\Microsoft.NET\Framework\v4.0.30319에서 이 DLL을 찾을 수 있습니다.
확인을 클릭합니다.
DebuggerSide.cs에서 다음 문을 Imports 문에 추가합니다.
```
Imports System.Windows.Forms
```

시각화 도우미의 사용자 인터페이스 만들기

이제 시각화 도우미의 사용자 인터페이스를 만들고 표시하는 코드를 추가합니다. 이 연습에서는 처음으로 시각화 도우미를 만드는 것이므로 사용자 인터페이스를 간단하게 유지하고 메시지 상자를 사용합니다.

시각화 도우미 출력을 대화 상자에 표시하려면

Show 메서드에 다음 코드 줄을 추가합니다.
```
MessageBox.Show(objectProvider.GetObject().ToString())
```
이 예시 코드에는 오류 처리 기능이 포함되어 있지 않습니다. 실제 시각화 도우미나 기타 유형의 애플리케이션을 만들 때는 오류 처리 기능을 포함해야 합니다.
빌드 메뉴에서 MyFirstVisualizer 빌드를 클릭합니다. 프로젝트가 성공적으로 빌드되어야 합니다. 빌드 오류가 발생하면 계속 진행하기 전에 이를 수정합니다.

필수 특성 추가

이제 디버거(debugger) 쪽 코드를 모두 작성했습니다. 그러나 여기에서 한 단계를 추가로 수행해야 합니다. 시각화 도우미를 구성하는 클래스 컬렉션을 디버기 쪽에 알리는 특성이 필요합니다.

디버기 측 코드에 대해 시각화할 형식을 추가하려면

디버거 쪽 코드에서 DebuggerVisualizerAttribute 특성을 사용하여 디버기에 대해 시각화할 형식(개체 소스)을 지정합니다. Target 속성은 시각화할 형식을 설정합니다.

DebuggerSide.vb의 Imports 문과 namespace MyFirstVisualizer 문 사이에 다음 특성 코드를 추가합니다.

<Assembly: System.Diagnostics.DebuggerVisualizer(GetType(MyFirstVisualizer.DebuggerSide), GetType(VisualizerObjectSource), Target:=GetType(System.String), Description:="My First Visualizer")>

빌드 메뉴에서 MyFirstVisualizer 빌드를 클릭합니다. 프로젝트가 성공적으로 빌드되어야 합니다. 빌드 오류가 발생하면 계속 진행하기 전에 이를 수정합니다.

테스트 도구 만들기

이제 첫 번째 시각화 도우미가 완성되었습니다. 각 단계를 올바르게 수행했다면 시각화 도우미를 빌드하고 Visual Studio에 설치할 수 있습니다. 그러나 시각화 도우미를 Visual Studio에 설치하기 전에 이를 테스트하여 올바르게 실행되는지 확인해야 합니다. 이제 시각화 도우미를 Visual Studio에 설치하지 않고 실행하는 테스트 환경을 만듭니다.

시각화 도우미를 표시하기 위한 테스트 메서드를 추가하려면

public DebuggerSide 클래스에 다음 메서드를 추가합니다.

Shared Public Sub TestShowVisualizer(ByVal objectToVisualize As Object)
    Dim visualizerHost As New VisualizerDevelopmentHost(objectToVisualize, GetType(DebuggerSide))
visualizerHost.ShowVisualizer()
End Sub

빌드 메뉴에서 MyFirstVisualizer 빌드를 클릭합니다. 프로젝트가 성공적으로 빌드되어야 합니다. 빌드 오류가 발생하면 계속 진행하기 전에 이를 수정합니다.

이제 시각화 도우미 DLL을 호출하기 위한 실행 파일 프로젝트를 만들어야 합니다. 작업을 간소화하기 위해 콘솔 애플리케이션 프로젝트를 사용합니다.

솔루션에 콘솔 애플리케이션 프로젝트를 추가하려면

솔루션 탐색기에서 솔루션을 마우스 오른쪽 단추로 클릭하고 추가를 선택한 후 새 프로젝트를 선택합니다.

검색 상자에 visual basic을 입력하고 템플릿을 선택한 다음 새 콘솔 앱 만들기(.NET Framework)를 선택합니다. 표시되는 대화 상자에서 만들기를 선택합니다.
클래스 라이브러리의 적절한 이름(예: MyTestConsole)을 입력한 다음 만들기 또는 확인을 클릭합니다.

이제 MyTestConsole에서 MyFirstVisualizer를 호출하는 데 필요한 참조를 추가해야 합니다.

MyTestConsole에 필요한 참조를 추가하려면

솔루션 탐색기에서 MyTestConsole을 마우스 오른쪽 단추로 클릭하고, 바로 가기 메뉴에서 참조 추가를 클릭합니다.
참조 추가 대화 상자의 찾아보기 탭에서 Microsoft.VisualStudio.DebuggerVisualizers를 클릭합니다.
확인을 클릭합니다.
MyTestConsole을 마우스 오른쪽 단추로 클릭한 다음, 참조 추가를 다시 클릭합니다.
참조 추가 대화 상자에서 프로젝트 탭을 클릭한 다음, MyFirstVisualizer를 선택합니다.
확인을 클릭합니다.

테스트 도구 끝내기 및 시각화 도우미 테스트

이제 테스트 환경을 끝내기 위한 코드를 추가합니다.

MyTestConsole에 코드를 추가하려면

솔루션 탐색기에서 Program.vb를 마우스 오른쪽 단추로 클릭하고, 바로 가기 메뉴에서 이름 바꾸기를 클릭합니다.
이름을 Module1.vb에서 TestConsole.vb 같은 적절한 이름으로 변경합니다.

Visual Studio에서는 새 파일 이름과 일치하도록 TestConsole.vb의 클래스 선언이 자동으로 변경된다는 점에 유의해야 합니다.
TestConsole. vb에서 다음 Imports 문을 추가합니다.
```
Imports MyFirstVisualizer
```
Main 메서드에 다음 코드를 추가합니다.
```
Dim myString As String = "Hello, World"
DebuggerSide.TestShowVisualizer(myString)
```
이제 첫 번째 시각화 도우미를 테스트할 준비가 되었습니다.

시각화 도우미를 테스트하려면

솔루션 탐색기에서 MyTestConsole를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 시작 프로젝트로 설정을 선택합니다.
디버그 메뉴에서 시작을 클릭합니다.

콘솔 애플리케이션이 시작됩니다. 시각화 도우미가 나타나고 "Hello, World."라는 문자열이 표시됩니다.

축하합니다. 첫 번째 시각화 도우미를 빌드하고 테스트했습니다.

시각화 도우미를 테스트 환경에서 호출하는 대신 Visual Studio에 사용하려면 이를 설치해야 합니다. 자세한 내용은 방법: 시각화 도우미 설치을 참조하세요.

다음을 통해 공유

연습: Visual Basic에서 시각화 도우미 작성

클래스 라이브러리 프로젝트 만들기 및 준비

클래스 라이브러리 프로젝트를 만들려면

Class1.vb의 이름을 바꾸고 Microsoft.VisualStudio.DebuggerVisualizers를 추가하려면

디버거 쪽 코드 추가

DialogDebuggerVisualizer에서 상속하려면

DialogDebuggerVisualizer.Show 메서드를 재정의하려면

System.Windows.Forms을 추가하려면

시각화 도우미의 사용자 인터페이스 만들기

시각화 도우미 출력을 대화 상자에 표시하려면

필수 특성 추가

디버기 측 코드에 대해 시각화할 형식을 추가하려면

테스트 도구 만들기

시각화 도우미를 표시하기 위한 테스트 메서드를 추가하려면

솔루션에 콘솔 애플리케이션 프로젝트를 추가하려면

MyTestConsole에 필요한 참조를 추가하려면

테스트 도구 끝내기 및 시각화 도우미 테스트

MyTestConsole에 코드를 추가하려면

시각화 도우미를 테스트하려면

피드백

피드백

추가 리소스

다음을 통해 공유

연습: Visual Basic에서 시각화 도우미 작성

클래스 라이브러리 프로젝트 만들기 및 준비

클래스 라이브러리 프로젝트를 만들려면

Class1.vb의 이름을 바꾸고 Microsoft.VisualStudio.DebuggerVisualizers를 추가하려면

디버거 쪽 코드 추가

DialogDebuggerVisualizer에서 상속하려면

DialogDebuggerVisualizer.Show 메서드를 재정의하려면

System.Windows.Forms을 추가하려면

시각화 도우미의 사용자 인터페이스 만들기

시각화 도우미 출력을 대화 상자에 표시하려면

필수 특성 추가

디버기 측 코드에 대해 시각화할 형식을 추가하려면

테스트 도구 만들기

시각화 도우미를 표시하기 위한 테스트 메서드를 추가하려면

솔루션에 콘솔 애플리케이션 프로젝트를 추가하려면

MyTestConsole에 필요한 참조를 추가하려면

테스트 도구 끝내기 및 시각화 도우미 테스트

MyTestConsole에 코드를 추가하려면

시각화 도우미를 테스트하려면

관련 콘텐츠

피드백

피드백

추가 리소스