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

아티클
08/20/2008

업데이트: 2007년 11월

이 항목은 다음 언어에 적용됩니다.

Edition	Visual Basic	C#	C++	Web Developer
Express
Standard
Pro 및 Team

표의 범례:

	해당
	해당 없음
	명령은 기본적으로 숨겨져 있습니다.

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

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

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

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

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

파일 메뉴에서 새로 만들기를 선택한 다음 새 프로젝트를 클릭합니다.
새 프로젝트 대화 상자의 프로젝트 형식 아래에서 Visual Basic을 클릭합니다.
템플릿 상자에서 클래스 라이브러리를 클릭합니다.
이름 상자에 MyFirstVisualizer 같이 적절한 클래스 라이브러리 이름을 입력합니다.
확인을 클릭합니다.

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

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

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

참고:

Visual Studio에서는 새 파일 이름과 일치하도록 DebuggerSide.vb의 클래스 선언이 자동으로 변경됩니다.
솔루션 탐색기에서 My First Visualizer를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 참조 추가를 클릭합니다.
참조 추가 대화 상자의 .NET 탭에서 Microsoft.VisualStudio.DebuggerVisualizers.DLL을 클릭합니다.
확인을 클릭합니다.
DebuggerSide.vb에서 다음 문을 Imports 문에 추가합니다.
```
Imports Microsoft.VisualStudio.DebuggerVisualizers
```

참고:
Visual Studio에서는 새 파일 이름과 일치하도록 DebuggerSide.vb의 클래스 선언이 자동으로 변경됩니다.

디버거측 코드 추가

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

DialogDebuggerVisualizer에서 상속하려면

DebuggerSide.vb에서 다음 코드 줄로 이동합니다.
```
Public Class DebuggerSide
```

코드를 다음과 같이 편집합니다.

Public Class DebuggerSide
Inherits DialogDebuggerVisualizer

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 메시지 상자를 사용하여 이 작업을 수행합니다. 먼저 System.Windows.Forms에 대한 참조와 Imports 문을 추가해야 합니다.

System.Windows.Forms을 추가하려면

솔루션 탐색기에서 참조를 마우스 오른쪽 단추로 클릭한 다음 바로 가기 메뉴에서 참조 추가를 클릭합니다.
참조 추가 대화 상자의 .NET 탭에서 System.Windows.Forms을 클릭합니다.
확인을 클릭합니다.
DebuggerSide.cs에서 다음 문을 Imports 문에 추가합니다.
```
Imports System.Windows.Forms
```

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

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

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

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

필수 특성 추가

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

디버기측 코드를 추가하려면

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을 호출하기 위한 실행 파일 프로젝트를 만들어야 합니다. 작업을 간소화하기 위해 콘솔 응용 프로그램 프로젝트를 사용합니다.

솔루션에 콘솔 응용 프로그램 프로젝트를 추가하려면

파일 메뉴에서 추가를 클릭한 다음 새 프로젝트를 클릭합니다.
새 프로젝트 추가 대화 상자의 템플릿 창에서 콘솔 응용 프로그램을 클릭합니다.
이름 상자에서 MyTestConsole 같은 의미 있는 이름을 콘솔 응용 프로그램에 부여합니다.
확인을 클릭합니다.

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

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

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

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

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

MyTestConsole에 코드를 추가하려면

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

Visual Studio에서는 새 파일 이름과 일치하도록 TestConsole.cs의 클래스 선언이 자동으로 변경된다는 점에 유의해야 합니다.
TestConsole.cs에서 다음과 같은 Imports 문을 추가합니다.
```
Imports MyFirstVisualizer
```

Main 메서드에 다음 코드를 추가합니다.

String myString = "Hello, World";
DebuggerSide.TestShowVisualizer(myString);

이제 첫 번째 시각화 도우미를 테스트할 준비가 되었습니다.

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

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

콘솔 응용 프로그램이 시작됩니다. 시각화 도우미가 나타나고 "Hello, World."라는 문자열이 표시됩니다.

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

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

참고 항목

다음을 통해 공유