Introducción al código DSL

ConnectionBuilders.cs

Un generador de conexión es una clase que crea relaciones.Es el código subyacente de una herramienta de conexión.Este archivo contiene un par de clases para cada herramienta de conexión.Los nombres son derivados de los nombres de la herramienta de la relación y la conexión de dominio: generador de relación, y ConnectorToolConnectAction.

(En el ejemplo componente de la solución, uno de los generadores de la conexión se denomina ConnectionBuilder, Esta es una coincidencia, ya que la relación de dominio se denomina Conexión.)

la relación se crea en el método de relaciónBuilder.Connect() .La versión predeterminada comprueba que los elementos del modelo de origen y de destino sean aceptables, y crea instancias de la relación.Por ejemplo:

CommentReferencesSubject(sourceAccepted, targetAccepted);

Cada clase de generador se genera de un nodo en la sección de Generadores de conexión en el Explorador de ADSL.Un método de Connect puede crear relaciones entre uno o más pares de clases de dominio.Cada par está definido por una directiva conectarse vínculo, que puede encontrar en el Explorador ADSL bajo el nodo del generador.

Por ejemplo, podría agregar un a las directivas se conectan de generador de conexión vínculo para cada uno de los tres tipos de relaciones en el ejemplo ADSL.Esto proporcionaría al usuario una sola herramienta de conexión.El tipo de relación creado instancias depende de los tipos de origen y de los elementos target seleccionado por el usuario.Para agregar el vínculo conectar las directivas, haga clic con el botón secundario en un generador en el Explorador de ADSL.

Para escribir código personalizado que se ejecuta cuando se crea un tipo específico de relación de dominio, seleccione la directiva conectarse vínculo apropiado bajo el nodo del generador.en la ventana Propiedades, establezca Utiliza custom conectar.Recompile la solución y, a continuación proporcione el código para corregir los errores resultantes.

Para escribir código personalizado que se ejecuta siempre que el usuario utilice esta herramienta de conexión, establezca la propiedad de es personalizado del generador de la conexión.Puede proporcionar código que decide si un elemento de origen está permitido, si una combinación concreta de origen y de destino se permite, y qué actualiza se debe crear el modelo cuando se crea una conexión.Por ejemplo, podría permitir una conexión únicamente si no crearía un bucle en el diagrama.En lugar de un único vínculo de la relación, puede crear instancias de un modelo más complejo de varios elementos correlacionados entre el origen y el destino.

Diagram.cs

contiene la clase que define el diagrama.es derivado de Diagram.

Para crear un color y otra variable de características de estilo en tiempo de ejecución, haga clic con el botón secundario en la clase del diagrama de la definición de ADSL y elija agregue expuesto.

Además, este archivo contiene la regla de FixupDiagram , que responde cuando un nuevo elemento se agrega al modelo.La regla agrega una nueva forma y vincula la forma al elemento de modelo.

DomainClasses.cs

Implementaciones de las clases de dominio que tiene definido, incluidas las clases abstractas y la clase modelo raíz.son derivados de ModelElement.

Cada clase de dominio contiene:

• Una definición de propiedad y una clase anidada del controlador para cada propiedad de dominio.Puede reemplazar OnValueChanging() y OnValueChanged().Para obtener más información, vea Controladores de los cambios de valor de propiedad de dominio.

  En el ejemplo ADSL, la clase de Comment contiene una propiedad Text y una clase TextPropertyHandlerde controlador.

• Propiedades de descriptor de acceso para las relaciones en las que esta clase de dominio combinaciones.(No hay ninguna clase anidada para el rol de las propiedades.)

  En el ejemplo ADSL, la clase de Comment tiene los descriptores de acceso al modelo primario con la relación ComponentModelHasCommentsde incrustación.

• constructores.Si desea invalidar estas, establezca tiene el constructor personalizado en la clase de dominio.

• Métodos de controlador de Prototipos (EGP) del grupo de elementos.Son necesarios si el usuario puede combinar (agregar) otro elemento sobre las instancias de esta clase.El usuario hace normalmente arrastrando de una herramienta u otra de elemento forma, o pegando.

  En el ejemplo ADSL, un puerto de conexión o un puerto de salida se puede combinar sobre un componente.Además, los componentes y los comentarios se pueden combinar sobre el modelo.El

  Los métodos del controlador de EGP en la clase de componente permiten que un componente acepte puertos, pero no los comentarios.El controlador de EGP en la clase del modelo raíz acepta comentarios y componentes, pero no los puertos.

DomainModelResx.resx

Contiene las cadenas como las descripciones de las clases y las propiedades de dominio, los nombres de propiedad, las etiquetas del cuadro de herramientas, los mensajes de error estándar, y otras cadenas que se pueden presentar al usuario.también contiene iconos y las imágenes de la herramienta para las formas de la imagen.

Este archivo se enlaza en el ensamblado compilado, y proporciona los valores predeterminados de estos recursos.Puede adaptar ADSL creando un ensamblado satélite que contiene una versión localizada de los recursos.Esa versión se utilizará cuando ADSL se instala en una referencia cultural que coincide con los recursos localizados.Para obtener más información, vea Implementar soluciones de lenguajes específicos de dominio.

HelpKeywordHelper.cs

Proporciona las funciones que se utilizan cuando el usuario presione F1.

PropertiesGrid.cs

Este archivo contiene código solo si tiene asociado un Descriptor de personalizados a una propiedad del dominio.Para obtener más información, vea Personalizar la ventana Propiedades.

Serializer.cs

Una clase de serializador para cada clase, relación, forma, conector, diagrama, y modelo de dominio.

Muchas de las características de estas clases se pueden controlar mediante los valores del Explorador ADSL en Comportamiento de serialización XML.

ToolboxHelper.cs

Establece el cuadro de herramientas instalando prototipos del grupo de elementos en las herramientas del elemento.Copias de estos prototipos se combinan con los elementos de destino cuando el usuario ejecuta la herramienta.

Podría invalidar CreateElementPrototype() para definir un elemento de cuadro de herramientas que crea un grupo de varios objetos.Por ejemplo, puede definir un elemento para representar objetos que tienen subcomponentes.Después de cambiar el código, restaure la instancia experimental de Visual Studio para borrar la memoria caché del cuadro de herramientas.

Constants.cs

GUID.

DocView.cs

TheDslDocView administra la ventana en la que el diagrama aparece.Por ejemplo, podría insertar el diagrama en un formulario de windows:

Agregue un archivo de control de usuario al proyecto de DslPackage.Agregar un panel en el que el diagrama puede mostrar.Agregue botones y otros controles.En la vista de código del formulario, agregue el código siguiente, ajustando los nombres a ADSL:

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

Busca los comandos de menú estándar en menús, tales como el menú contextual de diagrama, el menú de Editar , etc.el código para los comandos está en CommandSet.cs.Puede reubicar o modificar los comandos estándar, y puede agregar para sus propios comandos.Para obtener más información, vea Escribir acciones y comandos de usuario.

ModelExplorerToolWindow.cs

Define la ventana en la que aparece el explorador de modelos.Controla la selección de elementos en el explorador.

Source.extension.vsixmanifest

para personalizar este archivo, edite el archivo de .tt .

Precaución

Si edita el archivo .tt para incluir recursos como iconos o imágenes, asegúrese de que incluyan el recurso en la generación de VSIX.En el explorador de soluciones, seleccione el archivo y asegúrese de que la propiedad de Incluir en VSIX es True.

Este controles de archivos cómo ADSL se empaqueta en una extensión de integración de Visual Studio.Para obtener más información, vea Implementar soluciones de lenguajes específicos de dominio.