방법: 진단 데이터 어댑터 데이터용 사용자 지정 편집기 만들기

아티클
08/10/2011

진단 데이터 어댑터를 만드는 경우 테스트 설정에 대한 사용자 지정 진단 데이터 어댑터가 선택될 때 사용자가 특정 데이터를 구성할 수 있도록 설정할 수 있습니다. 예를 들어, 추출할 레지스트리 키, 시뮬레이트할 네트워크 부하 수준 또는 연결할 임시 파일이나 작업 파일을 찾을 디렉터리를 지정하는 구성 데이터를 선택할 수 있습니다.

구성 파일을 사용하여 진단 데이터 어댑터의 초기 값을 설정해야 합니다. 사용자가 구성 데이터를 수정할 수 있도록 해주는 사용자 지정 편집기를 제공할 수 있습니다.

편집기를 직접 만들려면 IDataCollectorConfigurationEditor를 구현하는 사용자 정의 컨트롤을 만듭니다.

진단 데이터 어댑터는 DataCollectorConfigurationEditorAttribute를 사용하여 진단 데이터 구성 설정을 편집하는 데 사용할 편집기 클래스를 지정할 수 있습니다.

또한 사용할 기본 구성 데이터를 지정합니다. 샘플 기본 구성은 진단 데이터 어댑터를 만들기 위한 샘플 프로젝트를 참조하십시오.

사용자 지정 진단 데이터 어댑터를 사용할 때 테스트 설정에 대한 데이터를 업데이트하는 사용자 지정 편집기를 만들려면 다음 절차를 수행합니다.

참고

사용자 지정 편집기를 만들려면 먼저 클래스에 DataCollectorConfigurationEditorAttribute가 적용된 진단 데이터 어댑터를 만들어야 합니다. 해당 특성의 선택적 HelpUri 속성을 사용하여 편집기의 도움말 콘텐츠 소스를 지정할 수 있습니다. 진단 데이터 어댑터를 만드는 방법에 대한 자세한 내용은 방법: 진단 데이터 어댑터 만들기를 참조하십시오.

사용자 지정 편집기를 비롯한 전체 예제 진단 데이터 어댑터 프로젝트는 진단 데이터 어댑터를 만들기 위한 샘플 프로젝트를 참조하십시오.

진단 데이터 어댑터용 사용자 지정 편집기 만들기

진단 데이터 어댑터용 사용자 지정 편집기를 만들려면

프로젝트에서 진단 데이터 어댑터용 사용자 정의 컨트롤을 만듭니다.
1. 진단 데이터 어댑터 클래스가 포함되어 있는 코드 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 사용자 정의 컨트롤을 가리킵니다.
2. 이 예제에서는 "Data File Name:"이라는 텍스트가 있는 레이블과 "FileTextBox"라는 텍스트 상자를 폼에 추가하여 사용자가 필요한 데이터를 입력할 수 있도록 합니다.
참고

현재 Windows Forms 사용자 정의 컨트롤만 지원됩니다.

다음 줄을 선언 섹션에 추가합니다.

using System.Xml;
using Microsoft.VisualStudio.TestTools.Common;
using Microsoft.VisualStudio.TestTools.Execution;

이 사용자 지정 컨트롤을 사용자 지정 편집기로 만듭니다.
1. 코드 프로젝트에서 사용자 정의 컨트롤을 마우스 오른쪽 단추로 클릭하고 코드 보기를 가리킵니다.
2. 다음과 같이 클래스에서 편집기 인터페이스 IDataCollectorConfigurationEditor를 구현하도록 설정합니다.
```
   public partial class MyDataConfigEditor :
        UserControl, IDataCollectorConfigurationEditor
```
1. 코드에서 IDataCollectorConfigurationEditor를 마우스 오른쪽 단추로 클릭하고 인터페이스 구현 명령을 선택합니다. 이 인터페이스에 대해 구현해야 할 메서드가 클래스에 추가됩니다.
2. 편집기에서 사용자 정의 컨트롤을 진단 데이터 어댑터 편집기로 식별하도록 해당 사용자 정의 컨트롤에 DataCollectorConfigurationEditorAttribute를 추가하고 회사, 제품 및 버전을 진단 데이터 어댑터에 대한 적합한 정보로 바꿉니다.
```
[DataCollectorConfigurationEditorTypeUri(
    "configurationeditor://MyCompany/MyConfigEditor/1.0")]
```

다음과 같이 두 개의 private 변수를 추가합니다.

private DataCollectorSettings collectorSettings;
private IServiceProvider ServiceProvider { get; set; }

진단 데이터 어댑터용 편집기를 초기화할 코드를 추가합니다. 설정 변수에 있는 데이터를 사용하여 사용자 정의 컨트롤의 필드에 기본값을 추가할 수 있습니다. 이는 어댑터에 대한 XML 구성 파일의 <DefaultConfiguration> 요소에 있는 데이터입니다.

public void Initialize(
    IServiceProvider svcProvider,
    DataCollectorSettings settings)
{
    ServiceProvider = svcProvider;
    collectorSettings = settings;

    // Display the default file name as listed in the settings file.
    this.SuspendLayout();
    this.FileTextBox.Text = getText(collectorSettings.Configuration);
    this.ResumeLayout();
}

다음과 같이 편집기에서 컨트롤의 데이터를 진단 데이터 어댑터 API에서 필요로 하는 XML 형식으로 다시 저장하는 코드를 추가합니다.

public DataCollectorSettings SaveData()
{
    collectorSettings.Configuration.InnerXml =
        String.Format(
@"<MyCollectorName
    http://MyCompany/schemas/MyDiagnosticDataCollector/1.0"">
  <File FullPath=""{0}"" />
</MyCollectorName>",
    FileTextBox.Text);
    return collectorSettings;
}

VerifyData 메서드에서 데이터가 올바른지 확인하는 코드를 추가하는 것이 중요합니다. 또는 이 메서드에서 true를 반환하도록 지정할 수 있습니다.
```
public bool VerifyData()
{
    // Not currently verifying data
    return true;
}
```

(선택 사항) 전용 getText() 메서드를 사용하는 ResetToAgentDefaults() 메서드에서 데이터를 XML 구성 파일에 제공된 초기 설정으로 다시 설정하는 코드를 추가할 수 있습니다.

// Reset to default value from XML configuration
// using a custom getText() method
public void ResetToAgentDefaults()
{
    this.FileTextBox.Text = getText(collectorSettings.DefaultConfiguration);
}

// Local method to read the configuration settings
private string getText(XmlElement element)
{
    // Setup namespace manager with our namespace
    XmlNamespaceManager nsmgr =
        new XmlNamespaceManager(
            element.OwnerDocument.NameTable);

    // Find all the "File" elements under our configuration
    XmlNodeList files = element.SelectNodes("//ns:MyCollectorName/ns:File", nsmgr);

    string result = String.Empty;
    if (files.Count > 0)
    {
        XmlAttribute pathAttribute = files[0].Attributes["FullPath"];
        if (pathAttribute != null &&
            !String.IsNullOrEmpty(pathAttribute.Value))
        {
            result = pathAttribute.Value;
        }
    }

    return result;
}

솔루션을 빌드합니다. 진단 데이터 어댑터 어셈블리 및 XML 구성 파일(<diagnostic data adapter name>.dll.config)을 사용자 설치 디렉터리를 기준으로 Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies\DataCollectors에 해당하는 위치에 복사합니다.

참고

구성 편집기는 진단 데이터 어댑터와는 다른 프로젝트 및 어셈블리에 있을 수도 있지만, 동일한 어셈블리에 있을 수도 있습니다.
테스트에서 진단 데이터 어댑터를 사용하려면 기존 테스트 설정 목록에서 선택하거나 Microsoft Test Manager 또는 Microsoft Visual Studio 2010에서 새 설정을 선택한 다음 진단 데이터 어댑터를 선택해야 합니다.

어댑터는 클래스에 할당된 이름으로 테스트 설정의 데이터 및 진단 탭에 표시됩니다.
테스트 설정에 대한 진단 데이터 어댑터를 구성하려면 어댑터 이름 옆의 구성을 클릭합니다.

이제 사용자 지정 편집기가 표시됩니다.
필요한 경우 사용자 지정 편집기에서 필드를 편집한 다음 저장을 클릭합니다.
Microsoft Test Manager에서 테스트를 실행할 경우 테스트를 실행하기 전에 테스트 계획에 이러한 테스트 설정을 할당하거나, 옵션과 함께 실행 명령을 사용하여 테스트 설정을 할당하고 테스트 설정을 재정의할 수 있습니다. 테스트 설정에 대한 자세한 내용은 테스트 설정을 사용하여 컴퓨터 설정 및 진단 정보 수집을 참조하십시오.
진단 데이터 어댑터가 있는 새 구성 편집기를 사용하기 전에 먼저 편집기를 사용할 각 진단 데이터 어댑터 클래스에 DataCollectorConfigurationEditorAttribute를 적용하고, 클라이언트 컴퓨터에서 다시 컴파일하고 다시 설치해야 합니다. 진단 데이터 어댑터와 구성 편집기를 설치하는 방법에 대한 자세한 내용은 방법: 사용자 지정 진단 데이터 어댑터 설치를 참조하십시오.
진단 데이터 어댑터가 선택된 테스트 설정을 사용하여 테스트를 실행합니다.

편집기에서 지정한 데이터 파일이 테스트 결과에 연결됩니다.

테스트를 실행할 때 환경을 사용하도록 테스트 설정을 구성하는 방법에 대한 자세한 내용은 수동 테스트에 대한 테스트 설정 만들기 또는 테스트 계획의 일부로 자동화된 테스트에 대한 테스트 설정 만들기를 참조하십시오.

참고 항목

다음을 통해 공유

방법: 진단 데이터 어댑터 데이터용 사용자 지정 편집기 만들기

진단 데이터 어댑터용 사용자 지정 편집기 만들기

진단 데이터 어댑터용 사용자 지정 편집기를 만들려면

참고 항목

작업

참조

개념

추가 리소스