了解 DSL 程式碼

ConnectionBuilders.cs

連接產生器是一個類別，會建立關聯性。它是 [連接] 工具背後的程式碼。這個檔案包含一對每個連接] 工具的類別。他們的名稱衍生自 「 網域關聯性和連線 」 工具的名稱： 關係產生器 」，以及 ConnectorToolConnectAction。

(如果元件方案範例中，呼叫 ConnectionBuilder 的其中一個連接產生器，這是這麼巧，因為網域關聯性的名稱是連線)。

在建立關聯性關係Builder.Connect()方法。預設版本驗證來源和目標模型項目是可以接受的關聯性會具現化。例如：

CommentReferencesSubject(sourceAccepted, targetAccepted);

每一個產生器類別從集中的節點產生的連接產生器 DSL 總管] 中的區段。一個Connect方法可以建立一或多個組的網域類別之間的關聯性。每一對連結連接詞，可以產生器] 節點下找到 DSL 總管] 中所定義。

比方說，您可以針對各種 DSL 的範例中的關聯性的三種將加入一個連接產生器連結連線的指示詞。這會讓使用者使用單一連線的工具。具現化的關聯性的類型而定的使用者所選取的來源和目標項目類型。若要新增連結連線的指示詞，以滑鼠右鍵按一下 DSL 總管] 中的產生器]。

若要撰寫自訂執行的程式碼建立特定類型的網域關聯性時，請選取適當連線的指示連接詞產生器] 節點下。在 [屬性] 視窗中，設定會使用自訂連線。重建方案，並再提供程式碼以更正產生的錯誤。

若要撰寫自訂執行程式碼，每當使用者使用此連接] 工具時，設定是自訂連線建立幫手的屬性。您可以提供決定是否允許來源項目，來源的特定組合是否允許目標，以及哪些更新程式應該設定成在模型建立連線時的程式碼。比方說，您可能會在圖表中建立一個迴圈時，才會允許連線。而非單一的關聯性連結，您可以執行個體化幾個來源和目標之間的 inter-related 項目更複雜的模式。

Diagram.cs

包含定義圖表的類別。它衍生自Diagram。

若要讓在執行階段的色彩和一些其他的樣式功能變數，以滑鼠右鍵按一下圖表上的 DSL 定義類別，並指向加入公開。

此外，這個檔案包含FixupDiagram規則，新的項目加入至模型時，會回應。此規則會新增一個圖案，並的圖形連結至的模型項目。

DomainClasses.cs

類別實作之網域已定義，包括抽象類別和模型的根類別。它們衍生自ModelElement。

每個網域類別包含：

• 屬性定義，每個網域內容的巢狀處理常式類別。您可以覆寫 OnValueChanging() 和 OnValueChanged()。如需詳細資訊，請參閱 網域屬性值變更處理常式。

  在範例 DSL、 Comment類別包含某個屬性， Text和處理常式類別TextPropertyHandler。

• 這個網域類別所參與的關聯性的存取子屬性。(有為角色屬性沒有巢狀的類別)。

  在範例 DSL、 Comment類別有存取它的父模型透過內嵌的關聯性的存取子ComponentModelHasComments。

• 建構函式。如果您想要覆寫這些，設定有自訂建構函式網域類別上。

• 項目群組原型 (EGP) 的處理常式方法。這些是有必要，如果使用者可以合併 (加入) 到此類別的執行個體上的另一個項目。通常使用者會從一個項目工具或另一個圖形，拖曳或貼上。

  此範例 DSL、 輸入連接埠或輸出連接埠可以合併到元件。此外，元件註解可以合併到模型。

  EGP 處理常式方法，在元件類別可以讓元件接受連接埠，但不是註解。註解和元件，但不是連接埠，就會接受 EGP 中的處理常式的根模型類別。

DomainModelResx.resx

這包含這類的網域類別和屬性、 屬性名稱、 工具箱標籤、 標準錯誤訊息，以及其他可能向使用者顯示的字串描述的字串。此外，它也會包含工具圖示和影像的圖形影像。

這個檔案所建置的組件中，繫結，並提供這些資源的預設值。您可以藉由建立附屬組件包含當地語系化的版本的資源當地語系化您的 DSL。DSL 安裝以符合當地語系化的資源文化特性時，將會使用該版本。如需詳細資訊，請參閱 部署網域指定的語言方案。

HelpKeywordHelper.cs

提供當使用者按下 F1 時所使用的函式。

PropertiesGrid.cs

這個檔案包含程式碼，只有當您附加自訂型別描述項至定義域屬性。如需詳細資訊，請參閱 自訂屬性視窗。

Serializer.cs

每個網域類別、 關聯性、 圖形、 連接器、 圖表中和模型的序列化程式類別。

許多這些類別的功能可以控制下的 DSL 總管] 中設定 Xml 序列化行為。

ToolboxHelper.cs

設定工具箱] 中，藉由安裝項目群組的原型，到項目的工具。當使用者執行此工具與目標項目合併這些原型的複本。

您可以覆寫CreateElementPrototype()來定義建立數個物件的一群的工具箱項目。例如，您可定義項目來代表具有子元件的物件。變更後的程式碼，重設實驗性的執行個體的Visual Studio來清除工具箱快取。

Constants.cs

Guid。

DocView.cs

YourDslDocView管理此圖表會出現的視窗。比方說，您無法內嵌圖表內表單的視窗：

DslPackage 專案中加入使用者控制項檔案。加入可以顯示在圖表中的面板。新增按鈕和其他控制項。在表單的 [程式碼] 檢視中，加入下列程式碼，調整到您的 DSL 名稱：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Shell;
namespace Company.EmbedInForm
{
  public partial class UserControl1 : UserControl
  {
    public UserControl1()
    {
      InitializeComponent();
    }
    
    private DiagramDocView docView;
    public UserControl1(DiagramDocView docView, Control content)
      : this()
    {
      this.docView = docView;
      panel1.Controls.Add(content);
    }
    private void button1_Click(object sender, EventArgs e)
    {
      ExampleModel modelRoot = this.docView.CurrentDiagram.ModelElement as ExampleModel;
      foreach (ExampleElement element in modelRoot.Elements)
      {
       listBox1.Items.Add(element.Name);
      }
    }
  }
  internal partial class EmbedInFormDocView
  {
    private ContainerControl container;
    /// <summary>
    /// Return a User Control instead of the DSL window. 
    /// The user control will contain the DSL window.
    /// </summary>
    public override System.Windows.Forms.IWin32Window Window
    {
      get
      {
        if (container == null)
        {
          // Put the normal DSL Window inside our control
          container = new UserControl1(this, (Control)base.Window);
        }
        return container;
      }
    }
  }
}

GeneratedVSCT.vsct

找出功能表，例如 [圖表內容] 功能表上的標準功能表命令編輯 功能表中，以此類推。命令的程式碼是在 CommandSet.cs 中。您可以重新配置，或修改標準的命令，您可以新增您自己的命令。如需詳細資訊，請參閱 撰寫使用者命令和動作。

ModelExplorerToolWindow.cs

定義用來顯示 [模型總管] 中的視窗。在 [檔案總管] 中的項目會處理。

Source.extension.vsixmanifest

若要自訂這個檔案，請編輯.tt檔案。

警告

如果您編輯包含資源，例如圖示或影像的.tt 檔案時，請確定資源已包含在 VSIX 的組建。在 [方案總管] 中，選取檔案，請確定加入至 VSIX 屬性是True。

此檔案會控制如何 DSL 封裝成 Visual Studio 整合副檔名 (VSIX)。如需詳細資訊，請參閱 部署網域指定的語言方案。