연습: C#에서 시각화 도우미 작성

아티클
05/17/2015

이 연습에서는 C#을 사용하여 간단한 시각화 도우미를 작성하는 방법을 보여 줍니다. 이 연습에서 만들 시각화 도우미는 Windows Forms 메시지 상자를 사용하여 문자열의 내용을 표시합니다. 이 간단한 문자열 시각화 도우미는 그 자체로는 그다지 유용하지 않지만 다른 데이터 형식에 보다 유용한 시각화 도우미를 만들 수 있는 기본적인 단계를 보여 줍니다.

참고

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

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

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

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

클래스 라이브러리를 만든 후에는 Microsoft.VisualStudio.DebuggerVisualizers.DLL에 대한 참조를 추가하여 여기에서 정의한 클래스를 사용할 수 있도록 해야 합니다. 그러나 참조를 추가하려면 먼저 몇몇 클래스의 이름을 의미 있는 이름으로 바꿔야 합니다.

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

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

참고

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

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

DialogDebuggerVisualizer에서 상속하려면

DebuggerSide.cs에서 다음 코드 줄로 이동합니다.
```
public class DebuggerSide
```

코드를 다음과 같이 변경합니다.

public class DebuggerSide : DialogDebuggerVisualizer

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

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

public class DebuggerSide에서 다음 메서드를 추가합니다.

override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
}

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

System.Windows.Forms을 추가하려면

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

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

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

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

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

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

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

[assembly:System.Diagnostics.DebuggerVisualizer(
typeof(MyFirstVisualizer.DebuggerSide),
typeof(VisualizerObjectSource),
Target  = typeof(System.String),
Description  = "My First Visualizer")]

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

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

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

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

public static void TestShowVisualizer(object objectToVisualize)
{
   VisualizerDevelopmentHost visualizerHost = new VisualizerDevelopmentHost(objectToVisualize, typeof(DebuggerSide));
   visualizerHost.ShowVisualizer();
}

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

이제 시각화 도우미 DLL을 호출하기 위한 실행 파일 프로젝트를 만들어야 합니다. 과정을 간단하게 진행하기 위해 콘솔 응용 프로그램 프로젝트를 사용합니다.

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

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

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

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

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

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

MyTestConsole에 코드를 추가하려면

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

편지지 Visual Studio에서 새 파일 이름과 일치하도록 TestConsole.cs의 클래스 선언이 자동으로 변경됩니다.
TestConsole.cs의 using 문에 다음 코드를 추가합니다.
```
using MyFirstVisualizer;
```

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

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

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

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

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

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

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

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

시각화 도우미 항목 템플릿 사용

지금까지 이 연습 과정에서는 시각화 도우미를 직접 만드는 방법을 소개했습니다. 이는 이해를 돕기 위한 연습이었으며, 이제 간단한 시각화 도우미의 작동 방식을 알았으므로 시각화 도우미 항목 템플릿을 사용하여 시각화 도우미를 더 쉽게 만드는 방법을 알아봅니다.

먼저 새 클래스 라이브러리 프로젝트를 만들어야 합니다.

새 클래스 라이브러리를 만들려면

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

이제 시각화 도우미 항목을 추가할 수 있습니다.

시각화 도우미 항목을 추가하려면

솔루션 탐색기에서 MySecondVisualizer를 마우스 오른쪽 단추로 클릭합니다.
바로 가기 메뉴에서 추가를 선택하고 새 항목을 클릭합니다.
새 항목 추가 대화 상자의 템플릿 아래에 있는 Visual Studio에 설치되어 있는 템플릿에서 디버거 시각화 도우미를 선택합니다.
이름 상자에 SecondVisualizer.cs 같이 적절한 이름을 입력합니다.
추가를 클릭합니다.

이로써 모든 작업을 마쳤습니다. SecondVisualizer.cs 파일을 살펴보고 템플릿을 통해 자동으로 추가된 코드를 확인하십시오. 코드를 여러 가지로 테스트해 볼 수도 있습니다. 이제 기본적인 방법을 익혔으므로 더 복잡하고 유용한 시각화 도우미를 직접 만들 수 있을 것입니다.

참고 항목

Share via