Informazioni sul codice DSL

ConnectionBuilders.cs

Un generatore di connessione è una classe che crea relazioni.È il code-behind di uno strumento della connessione.Questo file contiene una coppia di classi per ogni strumento della connessione.I nomi sono derivati dai nomi dello strumento di connessione e di relazione di dominio: relazionegeneratore e ConnectorToolConnectAction.

Nell'esempio parte della soluzione, uno dei generatori della connessione viene chiamato ConnectionBuilder, si tratta di una coincidenza, poiché la relazione di dominio è denominata Connection).

La relazione viene creata in relazioneBuilder.Connect() metodo.La versione predefinita di verificare che gli elementi del modello di destinazione e di origine siano accettabili e quindi creata un'istanza della relazione.Di seguito è riportato un esempio:

CommentReferencesSubject(sourceAccepted, targetAccepted);

Ogni classe del generatore viene generata da un nodo in Generatori di connessione sezione del linguaggio DSL Esplora Risorse.uno Connect il metodo può creare relazioni tra una o più coppie di classi di dominio.Ognuna delle quali è definita da un collegamento connette la direttiva, che è possibile trovare nel modello DSL Esplora Soluzioni nel nodo del generatore.

Ad esempio, è possibile aggiungere a un generatore di connessione il collegamento connettere le direttive per ciascuno dei tre tipi di relazioni nell'esempio DSL.Ciò fornisce all'utente con un unico strumento della connessione.Il tipo di relazione creare un'istanza dipenderebbe dai tipi di elementi di origine e di destinazione selezionati dall'utente.Per aggiungere il collegamento connettere le direttive, fare clic con il pulsante destro del mouse su un generatore nel modello DSL Esplora Risorse.

Per scrivere codice personalizzato che viene eseguito quando uno specifico tipo di relazione di dominio viene creato, selezionare il collegamento appropriato connettono la direttiva nel nodo del generatore.Nella Finestra Proprietà, impostare L'oggetto personalizzato di utilizzo si connette.Ricompilare la soluzione e quindi fornire codice per correggere gli errori risultanti.

Per scrivere codice personalizzato che viene eseguito ogni volta che l'utente utilizza lo strumento della connessione, impostare Viene personalizzato proprietà generatore di connessione.È possibile fornire codice che decide se un elemento di origine è valido, se una combinazione specifica di origine e di destinazione è valida e ciò che aggiorna deve essere effettuata al modello quando una connessione è stata eseguita.Ad esempio, è possibile consentire una connessione solo se non crei un ciclo nel diagramma.Invece di un singolo collegamento di relazione, è possibile creare un'istanza di un modello più complesso di vari elementi correlati tra origine e destinazione.

Diagram.cs

contiene la classe che definisce il diagramma.Deriva da Diagram.

Per fare in modo che il colore e un'altra variabile di funzionalità di stile in fase di esecuzione, fare clic con il pulsante destro del mouse sulla classe nel diagramma della definizione di modello DSL e indicare aggiungere esposto.

inoltre, questo file contiene FixupDiagram la regola, che risponda quando un nuovo elemento viene aggiunto al modello.La regola viene aggiunta una nuova forma e collega la forma all'elemento del modello.

DomainClasses.cs

Implementazioni di classi di dominio che definito, incluse le classi astratte e la classe della radice del modello.Derivano da ModelElement.

ogni classe di dominio contiene:

• Una definizione di proprietà e un gestore annidato classe per ogni proprietà del dominio.È possibile eseguire l'override di OnValueChanging() e OnValueChanged().Per ulteriori informazioni, vedere Gestori di modifica del valore delle proprietà del dominio.

  Nell'esempio DSL, Comment la classe contiene una proprietà Text e una classe del gestore TextPropertyHandler.

• Proprietà di accesso per le relazioni a cui questa classe di dominio partecipa.(Nessuna classe annidata per le proprietà del ruolo.)

  Nell'esempio DSL, Comment la classe dispone di funzioni di accesso che accedono al relativo modello del padre con la relazione includendo ComponentModelHasComments.

• costruttori.Se si desidera eseguire l'override di questi, impostare Un costruttore personalizzato nella classe di dominio.

• Metodi del gestore del (EGP) prototipo del gruppo di elementi.questi sono necessari se l'utente può unione (aggiungi) un altro elemento istanze di questa classe.In genere si esegue il trascinamento da uno strumento o da un altro elemento forma, o incollando.

  Nell'esempio DSL, un punto d'ingresso o una porta di output può essere estesa in un componente.Inoltre, i componenti e i commenti possono essere unite nel modello.L'attributo

  I metodi del gestore di EGP nella classe Component consentono di un componente accetta le porte, ma non i commenti.Il gestore di EGP nella classe di modello radice accetta i commenti e i componenti, ma non le porte.

DomainModelResx.resx

Questo file contiene le stringhe come le descrizioni delle classi di dominio e proprietà, nomi delle proprietà, etichette della casella degli strumenti, messaggi di errore standard e altre stringhe che possono essere visualizzati.Contiene inoltre le icone e le immagini degli strumenti per le forme di immagine.

Questo file è associato nell'assembly generato e fornisce valori predefiniti delle risorse.È possibile localizzare il modello DSL creare un assembly satellite contenente una versione localizzata di risorse.Tale versione verrà utilizzata quando il modello DSL è installato nelle impostazioni cultura che corrispondono alle risorse localizzate.Per ulteriori informazioni, vedere Distribuzione di soluzioni per un linguaggio specifico di dominio.

HelpKeywordHelper.cs

Fornisce funzioni utilizzate quando l'utente preme F1.

PropertiesGrid.cs

Questo file contiene il codice solo se è stato associato un descrittore di tipo personalizzato a una proprietà del dominio.Per ulteriori informazioni, vedere Personalizzazione della finestra Proprietà.

Serializer.cs

Una classe di serializzazione per ogni classe di dominio, relazione, la forma, connettore, diagramma e modello.

Molte delle funzionalità di queste classi possono essere controllate dalle impostazioni nel modello DSL Esplora Soluzioni sotto comportamento di serializzazione XML.

ToolboxHelper.cs

Configura la casella degli strumenti installando i prototipi del gruppo di elementi negli strumenti dell'elemento.Le copie dei prototipi sono unite agli elementi di destinazione quando l'utente esegue lo strumento.

È possibile eseguire l'override CreateElementPrototype() per definire un elemento della casella degli strumenti che crea un gruppo di diversi oggetti.Ad esempio, è possibile definire un elemento per rappresentare oggetti che hanno sottocomponenti.Dopo avere modificato il codice, reimpostare istanza sperimentale di Visual Studio per cancellare la cache della casella degli strumenti.

Constants.cs

GUID.

DocView.cs

TheDslDocView gestisce la finestra in cui il diagramma viene visualizzato.Ad esempio, è possibile includere il diagramma in un windows form:

Aggiungere un file di controllo utente al progetto DslPackage.Aggiungere un pannello in cui il diagramma può essere visualizzato.Per aggiungere pulsanti e altri controlli.Nella visualizzazione codice del form, aggiungere il codice seguente, regolante i nomi al modello 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

Individua i comandi di menu standard nei menu, ad esempio il menu di scelta rapida del diagramma, modifica menu, e così via.Il codice dei controlli è in CommandSet.cs.È possibile riassegnare o modificare i controlli standard e aggiungere per contenere i controlli.Per ulteriori informazioni, vedere Scrittura di azioni e comandi utente.

ModelExplorerToolWindow.cs

Definisce la finestra in cui in esplora modelli scegliere da modello di visualizzazione.Gestisce la selezione degli elementi nell'esploratore.

Source.extension.vsixmanifest

per personalizzare questo file, modificare .tt file.

Attenzione

Se si modifica il file .tt per includere risorse quali icone o immagini, assicurarsi che la risorsa sia inclusa nella compilazione VSIX.In Esplora soluzioni, selezionare il file e verificare che Importare in VSIX la proprietà è True.

Comandi del file come il modello DSL è compresso in un progetto VSIX (Visual Studio integration extension).Per ulteriori informazioni, vedere Distribuzione di soluzioni per un linguaggio specifico di dominio.