레이어 다이어그램에 사용자 지정 속성 추가

Visual Studio Ultimate 에서 레이어 다이어그램의 확장 코드를 작성할 때, 레이어 다이어그램의 모든 요소를 사용하여 값을 저장할 수 있습니다. 값은 다이어그램 저장되고 다시 열릴때 유지 됩니다. 또한 사용자가 보고 편집할 수 있도록 이러한 속성을 속성 창에 표시할 수 있습니다. 예를 들어, 사용자가 각 계층에서 클래스의 이름을 사용자가 지정한 패턴을 따르는지 확인 하기 위해 유효성 검사 코드를 작성하고 각 계층에 대해 정규식을 지정할 수 있습니다.

사용자에게 표시되지 않는 속성

레이어 다이어그램에 있는 모든 요소에 값을 연결 하기 위한 코드를 원한다면 MEF 구성 요소를 정의할 필요가 없습니다. ILayerElement 에서 Properties 라는 사전이 있습니다. 레이어 요소 사전에 마샬링할 수 값을 추가 하면 됩니다. 레이어 다이어그램의 일부로 저장 됩니다. 자세한 내용은 프로그램 코드에서 레이어 모델 탐색 및 업데이트을 참조하십시오.

사용자가 편집할 수 있는 속성

초기 준비

코드가 VSIX 프로젝트에 있는지 확인합니다

명령, 제스처 또는 유효성 검사 프로젝트 속성을 사용하는 경우 아무 것도 추가할 필요가 없습니다. MEF 구성 요소로 정의 된 Visual Studio 확장성 프로젝트에서 사용자 지정 속성에 대한 코드를 정의 합니다. 자세한 내용은 레이어 다이어그램에 명령 및 제스처 추가 또는 레이어 다이어그램에 사용자 지정 아키텍처 유효성 검사 추가를 참조하십시오.

사용자 지정 속성 정의

사용자 지정 속성을 만들려면 다음과 같이 클래스를 정의 합니다.

[Export(typeof(IPropertyExtension))]
public class MyProperty 
      : PropertyExtension<ILayerElement>
{
  // Implement the interface.
}

ILayerElement 또는 해당 파생된 클래스에서 속성을 정의할 수 있습니다. 여기서 말하는 클래스는 다음을 포함합니다:

• ILayerModel - 모델

• ILayer - 각 레이어

• ILayerDependencyLink - 레이어 간의 링크

• ILayerComment

• ILayerCommentLink

사용자 지정 속성을 보려면

사용자 지정 속성을 테스트 하려면 F5 키를 눌러 Visual Studio의 실험적 인스턴스를 시작 합니다. 적절 한 레이어 요소의 예를 만들고, 이것을 선택 합니다. 속성 창에서 사용자 지정 속성을 볼 수 있습니다.

예제

다음 코드는 일반적인 사용자 지정 속성 설명자입니다. 이 코드에서는 사용자가 사용자 지정 유효성 검사 메서드에 값을 제공할 수 있도록 하는 레이어 모델의 부울 속성(ILayerModel)을 정의합니다.

using System;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Layer;

namespace MyNamespace
{
  /// <summary>
  /// Custom properties are added to the Layer Designer via a custom
  /// Property Descriptor. We have to export this Property Descriptor
  /// using MEF to make it available in the Layer Designer.
  /// </summary>
  [Export(typeof(IPropertyExtension))]
  public class AllTypesMustBeReferencedProperty 
      : PropertyExtension<ILayerModel>
  {
    /// <summary>
    /// Each custom property must have a unique name. 
    /// Usually we use the full name of this class.
    /// </summary>
    public static readonly string FullName =
      typeof(AllTypesMustBeReferencedProperty).FullName;

    /// <summary>
    /// Construct the property. Notice the use of FullName.
    /// </summary>
    public AllTypesMustBeReferencedProperty()
            : base(FullName)
    {  }

    /// <summary>
    /// The display name is shown in the Properties window.
    /// We therefore use a localizable resource.
    /// </summary>
    public override string DisplayName
    {
      get { return Strings.AllTypesMustBeReferencedDisplayName; }
    }

    /// <summary>
    /// Description shown at the bottom of the Properties window.
    /// We use a resource string for easier localization.
    /// </summary>
    public override string Description
    {
      get { return Strings.AllTypesMustBeReferencedDescription; }
    }

    /// <summary>
    /// This is called to set a new value for this property. We must
    /// throw an exception if the value is invalid.
    /// </summary>
    /// <param name="component">The target ILayerElement</param>
    /// <param name="value">The new value</param>
    public override void SetValue(object component, object value)
    {
      ValidateValue(value);
      base.SetValue(component, value);
    }
    /// <summary>
    /// Helper to validate the value.
    /// </summary>
    /// <param name="value">The value to validate</param>
    private static void ValidateValue(object value)
    {  }

    public override Type PropertyType
    { get { return typeof(bool); } }

    /// <summary>
    /// The segment label of the properties window.
    /// </summary>
    public override string Category
    { 
      get
      {
        return Strings.AllTypesMustBeReferencedCategory;
      }
    }
  }
}

참고 항목

개념

레이어 다이어그램 확장