Opis kodu DSL

ConnectionBuilders.cs

Konstruktor połączenia jest klasa, która tworzy relacje.Jest to kod związany z narzędzia połączenia.Ten plik zawiera pary klas dla każdego narzędzia połączenia.Ich nazwy są uzyskiwane z nazwy domeny narzędzie relacji i połączenia: relacjikonstruktora, i ConnectorToolConnectAction.

(W przykładzie składnik rozwiązanie jednego z konstruktorów połączenia nosi nazwę ConnectionBuilder, to zbieżność, ponieważ relacja domeny nosi nazwę połączenia).

Ta relacja jest utworzona w relacjiBuilder.Connect() metody.Wersja domyślna sprawdza, czy elementy modelu źródłowego i docelowego są akceptowane i następnie tworzy relację.Na przykład:

CommentReferencesSubject(sourceAccepted, targetAccepted);

Każda klasa konstruktora jest generowany na podstawie węzła w Konstruktorzy połączenia sekcji w Eksploratorze DSL.Jeden Connect metody można tworzyć relacje między jedną lub więcej par klas domeny.Każda para jest zdefiniowany przez dyrektywy połączenia łącza, który można znaleźć w Eksploratorze DSL węźle konstruktora.

Można na przykład dodać do jednego połączenia konstruktora łącze Połącz dyrektyw, dla każdego z trzech typów relacji w próbce DSL.Dałoby to użytkownika za pomocą narzędzia do jednego połączenia.Typ relacji, których wystąpienia tworzone są zależą od typów elementów źródłowych i docelowych, wybrane przez użytkownika.Aby dodać łącze dyrektyw połączenia, kliknij prawym przyciskiem myszy konstruktora w Eksploratorze DSL.

Aby napisać kod niestandardowy, który jest uruchamiany, gdy jest tworzony określonego typu relacji domeny, zaznacz odpowiednie dyrektywy połączenia łącze w węźle konstruktora.W oknie dialogowym właściwości ustaw Niestandardowe korzysta z połączenia.Odbuduj roztworu, a następnie podaj kod wynikowy błędów.

Aby napisać kod niestandardowy, który jest uruchamiany w każdym przypadku, gdy użytkownik używa to narzędzie połączenia, należy ustawić Jest niestandardowy właściwość konstruktora połączenia.Można podać kod, który decyduje, czy element źródłowy jest dozwolone, czy określona kombinacja źródła i docelowych jest dozwolone, i jakie aktualizacje należy do modelu po nawiązaniu połączenia.Można na przykład zezwalania na połączenie tylko wtedy, gdy nie spowoduje utworzenia pętli na diagramie.Zamiast łącza pojedynczego relacji może utworzyć wystąpienia deseń bardziej złożonych z kilku elementów relację między źródłowym i docelowym.

Diagram.cs

Zawiera klasa, która definiuje diagramu.Wynika to z Diagram.

Aby kolor i niektóre inne stylu Zmienna funkcje w czasie wykonywania, kliknij prawym przyciskiem myszy klasę na diagramie definicji DSL i wskaż Dodać narażonych.

Ponadto, ten plik zawiera FixupDiagram regułę, która reaguje, gdy nowy element jest dodawany do modelu.Reguła jest dodawany nowy kształt i łączy kształt element modelu.

DomainClasses.cs

Implementacje klasy domeny, które są zdefiniowane, łącznie z klasy abstrakcyjne i klasy modelu głównego.Pochodzą one z ModelElement.

Każda klasa domeny zawiera:

• Definicja właściwości i klasy obsługi zagnieżdżone dla każdej właściwości domeny.Można zastąpić, OnValueChanging() i OnValueChanged().Aby uzyskać więcej informacji, zobacz Domen właściwość wartość zmiany obsługi.

  W przykładzie DSL Comment klasy zawiera właściwość Text i klasy obsługi TextPropertyHandler.

• Akcesor właściwości relacji, w których uczestniczy klasy tej domeny.(Nie jest żadna z klas zagnieżdżonych dla właściwości roli).

  W przykładzie DSL Comment klasa ma akcesorów łączących się z jego nadrzędnego modelu za pomocą relacji osadzania ComponentModelHasComments.

• Konstruktory.Jeśli chcesz zastąpić te Ma niestandardowy konstruktor w klasie domeny.

• Element metody obsługi grupy prototyp (EPZ).Są one niezbędne, jeśli użytkownik może korespondencji seryjnej (Dodaj) inny element na wystąpienia tej klasy.Zazwyczaj użytkownik wykona to przeciągając narzędziem elementu lub innego kształtu lub wklejając.

  W przykładzie DSL, Input portu lub dane wyjściowe mogą być scalane na składnik.Ponadto składniki i komentarze mogą być scalane na modelu.W

  Metody obsługi EGP w klasie Component umożliwia składnik, aby zaakceptować portów, ale nie komentarze.Obsługa EGP klasy modelu głównego akceptuje komentarze i składników, ale nie portów.

DomainModelResx.resx

Ten element zawiera ciągi znaków, takie jak opis klas domeny i właściwości, nazwy właściwości, etykiety przybornik, błąd standardowy wiadomości i inne ciągi znaków, które mogą być wyświetlane dla użytkownika.Zawiera również narzędzie ikony i obrazów, kształtów obrazu.

Plik ten jest związany, do montażu zbudowany i zapewnia domyślne wartości tych zasobów.Przez utworzenie zestawu satelickiego, zawierający zlokalizowaną wersję zasoby można lokalizować linii DSL.Tej wersji będą używane, gdy modem DSL jest zainstalowany w kulturze, dobierając zasoby zlokalizowane.Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązań języka specyficzne dla domeny.

HelpKeywordHelper.cs

Zawiera funkcje, które są używane, gdy użytkownik nacionie klawisz F1.

PropertiesGrid.cs

Ten plik zawiera kod, tylko wtedy, gdy zostały podłączone deskryptora typu niestandardowe właściwości domeny.Aby uzyskać więcej informacji, zobacz Dostosowywanie okna właściwości.

Serializer.cs

Klasę serializator dla każdej klasy domeny, relacji, kształt, łącznika, diagramu i modelu.

Wiele funkcji tych klas można kontrolować za pomocą ustawień w programie Explorer DSL pod Zachowanie serializacji Xml.

ToolboxHelper.cs

Konfiguruje przybornik, instalując element grupy prototypów do narzędzia elementu.Kopie te prototypy są scalane z elementów docelowych, gdy użytkownik uruchomi narzędzie.

Można zastąpić CreateElementPrototype() do definiowania element przybornika, który tworzy grupę kilka obiektów.Na przykład można zdefiniować element do reprezentowania obiektów, które mają pełnotekstowe.Po zmianie kodu, należy zresetować doświadczalnych wystąpienie Visual Studio , aby wyczyścić pamięć podręczną przybornika.

Constants.cs

Identyfikatory GUID.

DocView.cs

YourDslDocView zarządza okna, w której znajduje się diagram.Na przykład można osadzić diagramu wewnątrz okien formularza:

Dodaj plik formantu użytkownika do projektu DslPackage.Dodawanie panelu, w którym mogą być wyświetlane diagramu.Dodawanie przycisków i innych formantów.W widoku Kod formularza dodaj następujący kod, dostosowując nazw do linii 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

Lokalizuje standardowych poleceń menu, takich jak menu kontekstowego diagram Edytuj menu i tak dalej.Kod dla poleceń znajduje się w CommandSet.cs.Można przenieść lub modyfikować standardowe polecenia i można dodać swoje własne polecenia.Aby uzyskać więcej informacji, zobacz Zapisywanie poleceń użytkownika i działania.

ModelExplorerToolWindow.cs

Definiuje okno, w którym jest wyświetlany Eksploratora modelu.Uchwyty zaznaczenia elementów w Eksploratorze.

Source.Extension.vsixmanifest

Aby dostosować ten plik, należy edytować .tt pliku.

Przestroga

Jeśli edytujesz plik .tt zasoby, takie jak ikony lub obrazy, upewnij się, że zasób jest włączone w kompilacji VSIX.W oknie Solution Explorer wybierz plik i upewnij się, że Dołącz VSIX jest właściwość True.

Plik ten kontroluje, w jaki sposób modem DSL jest spakowany w Visual Studio Integration Extension (VSIX).Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązań języka specyficzne dla domeny.