Visual Studio Modelbus によるモデルの統合

[アーティクル]
05/19/2015

Visual Studio ModelBus はモデル間および他のツールからモデルへのリンクを作成するためのメソッドを提供します。たとえば、ドメイン固有言語 (DSL) モデルと UML モデルをリンクできます。 DSL の統合セットを作成できます。

ModelBus により、モデルまたはモデル内の特定の要素への一意の参照を作成できます。この参照は、たとえば、別のモデル内の要素など、モデルの外に保存できます。後で何らかのツールにおいて要素へのアクセスを取得する必要が生じると、モデルバスインフラストラクチャは適切なモデルを読み込み、要素を返します。必要があれば、モデルをユーザーに表示できます。ファイルが以前の場所でアクセスできない場合、ModelBus はユーザーにファイルを見つけるように求めます。ユーザーがファイルを見つけると、ModelBus はそのファイルへのすべての参照を解決します。

注意

ModelBus の現在の Visual Studio 実装では、リンクされたモデルは同じ Visual Studio ソリューション内の項目である必要があります。

追加情報とサンプルコードについては、以下を参照してください。

DSL へのアクセスの提供

モデルまたはその要素への ModelBus 参照を作成するには、DSL の ModelBusAdapter を定義しておく必要があります。そのための最も簡単な方法は、Visual Studio モデルバス拡張機能を使用して、コマンドを DSL デザイナーに追加することです。

DSL 定義をモデルバスに公開するには

Visual Studio モデルバス拡張機能をまだインストールしていない場合はダウンロードしてインストールします。詳細については、「Visualization and Modeling SDK」を参照してください。
DSL 定義ファイルを開きます。デザインサーフェイスを右クリックし、[Modelbus の有効化] をクリックします。
ダイアログボックスで、[この DSL を ModelBus に公開する] を選択します。この DSL のモデルを公開すると同時に他の DSL への参照を利用する場合は、両方のオプションを選択できます。
[OK] をクリックします。新しいプロジェクト "ModelBusAdapter" が DSL ソリューションに追加されます。
テキストテンプレートから DSL にアクセスする場合、新しいプロジェクトで AdapterManager.tt を変更する必要があります。コマンドやイベントハンドラーなどの他のコードから DSL にアクセスする場合はこの手順を省略します。詳細については、「テキストテンプレートでの Visual Studio ModelBus の使用」を参照してください。
1. AdapterManagerBase の基底クラスを VsTextTemplatingModelingAdapterManager に変更します。
2. ファイルの終わり近くで、クラス AdapterManager の前に次の追加属性を挿入します。
  
  [Microsoft.VisualStudio.Modeling.Integration.HostSpecific(HostName)]
3. ModelBusAdapter プロジェクトの参照に、Microsoft.VisualStudio.TextTemplating.Modeling.11.0 を追加します。
テキストテンプレートと他のコードの両方から DSL にアクセスするには、変更したアダプターと変更していないアダプターの 2 つが必要です。
[すべてのテンプレートの変換] をクリックします。
ソリューションをリビルドします。

これで ModelBus がこの DSL のインスタンスを開くことができるようになります。

フォルダー ModelBusAdapters\bin\* には、Dsl プロジェクトと ModelBusAdapters プロジェクトによりビルドされるアセンブリが含まれます。この DSL を別の DSL から参照するには、これらのアセンブリをインポートする必要があります。

要素が参照可能であることの確認

Visual Studio ModelBus アダプターは、既定では、要素を特定するためにその GUID を使用します。したがって、これらの ID はモデルファイル内に保持される必要があります。

要素 ID が保持されることを確認するには

DslDefinition.dsl を開きます。
DSL エクスプローラーで、[Xml Serialization Behavior]、[クラスデータ] の順に展開します。
モデルバス参照を作成する各クラスについて、次の操作を実行します。

クラスノードをクリックし、[プロパティ] ウィンドウで、[ID のシリアル化] を true に設定します。

または、GUID ではなく要素名を使用して要素を特定する場合、生成されたアダプターの各部をオーバーライドできます。アダプタークラス内の次のメソッドをオーバーライドします。

GetElementId をオーバーライドし、使用する ID を返します。このメソッドは参照を作成するときに呼び出されます。
ResolveElementReference をオーバーライドし、モデルバス参照から正しい要素を特定します。

別の DSL からの DSL のアクセス

DSL のドメインプロパティにモデルバス参照を保存し、それらを使用するカスタムコードを作成できます。ユーザーがモデルファイルとその中の要素を選択することにより、モデルバス参照を作成可能にすることもできます。

DSL が別の DSL への参照を使用可能にするには、まずそれをモデルバス参照のコンシューマーにする必要があります。

DSL が公開されている DSL への参照を利用可能にするには

DSL 定義図で、図の主要部を右クリックし、[Modelbus の有効化] をクリックします。
ダイアログボックスで、[このモデルがモデルバス参照を利用可能にする] を選択します。
利用する DSL の Dsl プロジェクトで、次のアセンブリをプロジェクト参照に追加します。これらのアセンブリ (.dll ファイル) は、公開されている DSL の ModelBusAdapter\bin\* ディレクトリにあります。
- 公開されている DSL アセンブリ。たとえば、Fabrikam.FamilyTree.Dsl.dll
- 公開されているモデルバスアダプターアセンブリ。たとえば、Fabrikam.FamilyTree.ModelBusAdapter.dll
次の .NET アセンブリを利用する DSL プロジェクトのプロジェクト参照に追加します。
1. Microsoft.VisualStudio.Modeling.Sdk.Integration.11.0.dll
2. Microsoft.VisualStudio.Modeling.Sdk.Integration.Shell.11.0.dll

モデルバス参照をドメインプロパティに保存するには

利用する DSL の DSL 定義で、ドメインクラスにドメインプロパティを追加し、その名前を設定します。
[プロパティ] ウィンドウで、ドメインプロパティを選択し、[型] を ModelBusReference に設定します。

この段階で、プログラムコードはプロパティ値を設定できますが、[プロパティ] ウィンドウでは読み取り専用です。

ユーザーが特殊な ModelBus 参照エディターを使用してプロパティを設定可能にすることができます。このエディターまたはピッカーには 2 つのバージョンがあり、1 つはユーザーがモデルファイルを選択するため、もう 1 つはユーザーがモデルファイルとモデル内の要素を選択するためのものです。

ユーザーがモデルバス参照をドメインプロパティに設定可能にするには

ドメインプロパティを右クリックし、[ModelBusReference 固有プロパティの編集] をクリックします。ダイアログボックスが開きます。これはモデルバスピッカーです。
モデルまたはモデル内の要素に対して、適切な [ModelBusReference の種類] を選択します。
ファイルダイアログフィルター文字列に、Family Tree files |*.ftree のような文字列を入力します。公開される DSL のファイル拡張子を置き換えます。
モデル内の要素を参照する場合、ユーザーが選択可能な型の一覧を追加します (たとえば、Company.FamilyTree.Person)。
[OK] をクリックし、ソリューションエクスプローラーツールバーの [すべてのテンプレートの変換] をクリックします。

注意

有効なモデルまたはエンティティを選択しなかった場合、[OK] ボタンが有効のように見えても効果はありません。
Company.FamilyTree.Person などのターゲット型の一覧を指定した場合、DSL プロジェクトにアセンブリ参照を追加して、ターゲット DSL の DLL (たとえば、Company.FamilyTree.Dsl.dll) を参照する必要があります。

モデルバス参照をテストするには

公開される DSL と利用する DSL の両方をビルドします。
F5 キーまたは CTRL+F5 キーを押して、DSL のいずれかを実験モードで実行します。
Visual Studio の実験インスタンスのデバッグプロジェクトで、各 DSL のインスタンスであるファイルを追加します。

注意

Visual Studio ModelBus は、同じ Visual Studio ソリューション内の項目である、モデルへの参照のみを解決できます。たとえば、ファイルシステムの別の部分にあるモデルファイルへの参照は作成できません。
公開される DSL のインスタンス内に要素とリンクを作成し、インスタンスを保存します。
利用する DSL のインスタンスを開き、モデルバス参照プロパティを持つモデル要素を選択します。
[プロパティ] ウィンドウで、モデルバス参照プロパティをダブルクリックします。ピッカーダイアログが開きます。
[参照] をクリックし、公開される DSL のインスタンスを選択します。

モデルバス参照の要素固有の種類を指定した場合、ピッカーではモデル内の項目を選択することもできます。

プログラムコード中の参照の作成

モデルまたは要素への参照をモデル内に保存する場合、ModelBusReference を作成します。 ModelBusReference にはモデル参照と要素参照の 2 種類があります。

モデル参照を作成するには、モデルがインスタンスになっている DSL の AdapterManager と、モデルのファイル名または Visual Studio プロジェクト項目が必要です。

要素参照を作成するには、モデルファイルと参照する要素のアダプターが必要です。

注意

Visual Studio ModelBus を使用して、同じ Visual Studio ソリューション内の項目への参照のみを作成できます。

公開されている DSL アセンブリのインポート

利用するプロジェクトで、DSL へのプロジェクト参照と公開されている DSL の ModelBusAdapter アセンブリを追加します。

たとえば、ModelBus References を MusicLibrary DSL の要素に保存するとします。 ModelBus References は FamilyTree DSL の要素を参照します。 MusicLibrary ソリューションの Dsl プロジェクトで、References ノードに次のアセンブリへの参照を追加します。

Fabrikam.FamilyTree.Dsl.dll - 公開されている DSL。
Fabrikam.FamilyTree.ModelBusAdapters.dll - 公開されている DSL の ModelBus アダプター。
Microsoft.VisualStudio.Modeling.Sdk.Integration.11.0
Microsoft.VisualStudio.Modeling.Sdk.Integration.Shell.11.0

これらのアセンブリは、公開されている DSL の ModelBusAdapters プロジェクトの bin\* の下にあります。

参照を作成するコードファイルで、通常、次の名前空間をインポートする必要があります。

// The namespace of the DSL you want to reference:
using Fabrikam.FamilyTree;  // Exposed DSL
using Fabrikam.FamilyTree.ModelBusAdapters;
using Microsoft.VisualStudio.Modeling.Integration;
using System.Linq;
...

モデルへの参照を作成するには

モデル参照を作成するには、公開されている DSL の AdapterManager にアクセスし、それを使用してモデルへの参照を作成します。ファイルパスまたは EnvDTE.ProjectItem のどちらかを指定できます。

AdapterManager から、Adapter を取得し、モデル内の個々の要素にアクセスできます。

注意

操作を終了したら、Adapter を破棄する必要があります。そのための最も便利な方法は、using ステートメントの使用です。次に例を示します。

// The file path of a model instance of the FamilyTree DSL:
string targetModelFile = "TudorFamilyTree.ftree";
// Get the ModelBus service:
IModelBus modelBus = 
    this.Store.GetService(typeof(SModelBus)) as IModelBus;
// Get an adapterManager for the target DSL:
FamilyTreeAdapterManager manager = 
    (modelbus.GetAdapterManager(FamilyTreeAdapter.AdapterId) 
     as FamilyTreeAdapterManager;
// or: (modelBus.FindAdapterManagers(targetModelFile).First())
// or could provide an EnvDTE.ProjectItem

// Create a reference to the target model:
// NOTE: the target model must be a file in this project.
ModelBusReference modelReference =
     manager.CreateReference(targetModelFile);
// or can use an EnvDTE.ProjectItem instead of the filename

// Get the root element of this model:
using (FamilyTreeAdapter adapter = 
     modelBus.CreateAdapter(modelReference) as FamilyTreeAdapter)
{
  FamilyTree modelRoot = adapter.ModelRoot;
  // Access elements under the root in the usual way:
  foreach (Person p in modelRoot.Persons) {...}
  // You can create adapters for individual elements:
  ModelBusReference elementReference =
     adapter.GetElementReference(person);
  ...
} // Dispose adapter

後で modelReference を使用可能にする場合、外部型 ModelBusReference を持つドメインプロパティに保存できます。

using Transaction t = this.Store.TransactionManager
    .BeginTransaction("keep reference"))
{
  artist.FamilyTreeReference = modelReference;
  t.Commit();
}

ユーザーがこのドメインプロパティを編集可能にするには、Editor 属性のパラメーターとして ModelReferenceEditor を使用します。詳細については、「ユーザーによる参照編集を可能にする」を参照してください。

要素への参照を作成するには

モデル用に作成したアダプターは参照の作成と解決のために使用できます。

// person is an element in the FamilyTree model:
ModelBusReference personReference = 
  adapter.GetElementReference(person);

後で elementReference を使用可能にする場合、外部型 ModelBusReference を持つドメインプロパティに保存できます。ユーザーがそれを編集可能にするには、Editor 属性のパラメーターとして ModelElementReferenceEditor を使用します。詳細については、「ユーザーによる参照編集を可能にする」を参照してください。

参照の解決

ModelBusReference (MBR) がある場合、モデルまたはモデルが参照するモデル要素を取得できます。要素が図またはその他の表示に示されている場合、表示を開き、要素を選択できます。

MBR からアダプターを作成できます。アダプターから、モデルのルートを取得できます。モデル内の特定の要素を参照する MBR を解決することもできます。

using Microsoft.VisualStudio.Modeling.Integration; ...
ModelBusReference elementReference = ...;

// Get the ModelBus service:
IModelBus modelBus = 
    this.Store.GetService(typeof(SModelBus)) as IModelBus;
// Use a model reference or an element reference
// to obtain an adapter for the target model:
using (FamilyTreeAdapter adapter = 
   modelBus.CreateAdapter(elementReference) as FamilyTreeAdapter)
   // or CreateAdapter(modelReference)
{
  // Get the root of the model:
  FamilyTree tree = adapter.ModelRoot;

  // Get a model element:
  MyDomainClass mel =
    adapter.ResolveElementReference<MyDomainClass>(elementReference);
  if (mel != null) {...}

  // Get the diagram or other view, if there is one:
  ModelBusView view = adapter.GetDefaultView();
  if (view != null) 
  {
   view.Open();
   // Display the diagram:
   view.Show(); 
   // Attempt to select the shape that presents the element:
   view.SetSelection(elementReference);
  }
} // Dispose the adapter.

テキストテンプレート内の ModelBus References を解決するには

アクセスする DSL には、テキストテンプレートによるアクセスのために構成された ModelBus Adapter が含まれている必要があります。詳細については、「To provide access to a DSL」を参照してください。

通常、ソース DSL 内に保存されたモデルバス参照 (MBR) を使用してターゲット DSL にアクセスします。したがって、テンプレートにはソース DSL のディレクティブに加えて、MBR を解決するためのコードが含まれています。テキストテンプレートの詳細については、「ドメイン固有言語からのコード生成」を参照してください。

<#@ template debug="true" hostspecific="true" 
inherits="Microsoft.VisualStudio.TextTemplating.Modeling.ModelBusEnabledTextTransformation" #> 
<#@ SourceDsl processor="SourceDslDirectiveProcessor" requires="fileName='Sample.source'" #>
<#@ output extension=".txt" #>
<#@ assembly name = "Microsoft.VisualStudio.Modeling.Sdk.Integration.11.0" #>
<#@ assembly name = "System.Core" #>
<#@ assembly name = "Company.CompartmentDragDrop.Dsl.dll" #>
<#@ assembly name = "Company.CompartmentDragDrop.ModelBusAdapter.dll" #>
<#@ import namespace="Microsoft.VisualStudio.Modeling.Integration" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="Company.CompartmentDragDrop" #>
<#@ import namespace="Company.CompartmentDragDrop.ModelBusAdapters" #>
<# // Get source root from directive processor:
  ExampleModel source = this.ExampleModel; 
  // This DSL has a MBR in its root:
using (ModelBusAdapter adapter = this.ModelBus.CreateAdapter(source.ModelReference) as ModelBusAdapter) 
  {
  ModelBusAdapterManager manager = this.ModelBus.FindAdapterManagers(this.Host.ResolvePath("Sample.compDD1")).FirstOrDefault();
  ModelBusReference modelReference =
    manager.CreateReference(this.Host.ResolvePath("Sample.compDD1"));

  // Get the root element of this model:
  using (CompartmentDragDropAdapter adapter = 
     this.ModelBus.CreateAdapter(modelReference) as CompartmentDragDropAdapter)
  {
    ModelRoot root = adapter.ModelRoot;
#>
[[<#= root.Name #>]]
<#
  }
#>

詳細とチュートリアルについては、「テキストテンプレートでの Visual Studio ModelBus の使用」を参照してください。

ModelBusReference のシリアル化

ModelBusReference (MBR) を文字列形式で保存する場合、次のようにシリアル化することができます。

string serialized = modelBus.SerializeReference(elementReference);
// Store it anywhere, then get it back again:
ModelBusReference elementReferenceRestored =
    modelBus.DeserializeReference(serialized, null);

この方法でシリアル化される MBR はコンテキストに依存しません。単純なファイルベースのモデルバスアダプターを使用している場合、MBR には絶対ファイルパスが含まれます。これはインスタンスモデルファイルが絶対に移動しない場合は十分です。ただし、モデルファイルは通常、Visual Studio プロジェクト内の項目です。ユーザーはプロジェクト全体をファイルシステムの異なる場所へ移動できると期待しています。ユーザーはプロジェクトをソース管理の下に維持し、異なるコンピューターで開くこともできると期待しています。したがって、パス名はファイルを含むプロジェクトの場所を基準とする相対値としてシリアル化する必要があります。

指定されたファイルパスを基準とする相対シリアル化

ModelBusReference には、相対シリアル化の基準となるファイルパスなどの情報を含めることが可能なディクショナリである ReferenceContext が含まれています。

パス相対シリアル化を実行するには、次の操作を実行します。

elementReference.ReferenceContext.Add(
   ModelBusReferencePropertySerializer.FilePathSaveContextKey, 
   currentProjectFilePath);
string serialized = modelBus.SerializeReference(elementReference);

次の文字列から参照を取得するには

ReferenceContext context = new ReferenceContext();
context.Add(ModelBusReferencePropertySerializer.FilePathLoadContextKey,
    currentProjectFilePath);
ModelBusReference elementReferenceRestored =
    modelBus.DeserializeReference(serialized, context);

他のアダプターにより作成された ModelBusReferences

独自のアダプターを作成する場合、次の情報が役立ちます。

ModelBusReference (MBR) は、モデルバスにより逆シリアル化される MBR ヘッダーと特定のアダプターマネージャーにより処理されるアダプター固有部分の 2 つの部分で構成されます。これにより、独自のアダプターシリアル化形式を提供できます。たとえば、ファイルではなくデータベースを参照したり、アダプター参照に追加情報を保存したりすることできます。独自のアダプターは ReferenceContext に追加情報を配置することもできます。

MBR を逆シリアル化する場合、ReferenceContext を指定する必要があり、これは MBR オブジェクト内に保存されます。 MBR をシリアル化する場合、保存された ReferenceContext はアダプターが文字列の生成を助けるために使用されます。逆シリアル化された文字列には ReferenceContext 内のすべての情報が含まるわけではありません。たとえば、単純なファイルベースのアダプターで、ReferenceContext はルートファイルパスを含みますが、これはシリアル化された MBR 文字列に保存されません。

MBR は次の 2 つの段階で逆シリアル化されます。

ModelBusReferencePropertySerializer は MBR ヘッダーを処理する、標準のシリアライザーです。これは標準の DSL SerializationContext プロパティバッグを使用し、このプロパティバッグは, キー ModelBusReferencePropertySerializer.ModelBusLoadContextKey を使用する ReferenceContext に保存されています。特に、SerializationContext は ModelBus のインスタンスを含む必要があります。
ModelBus Adapter は MBR のアダプター固有部分を処理します。これは MBR の ReferenceContext に保存されている追加情報を使用できます。単純なファイルベースのアダプターは、キー FilePathLoadContextKey および FilePathSaveContextKey を使用してルートファイルパスを維持します。

モデルファイル内のアダプター参照は使用されるときにのみ逆シリアル化されます。

モデルを作成するには

モデルの作成、オープン、および編集

次のフラグメントは、VMSDK Web サイトの State Machine サンプルから取得したものです。ここには、ModelBusReferences を使用した、モデルの作成とオープン、およびモデルに関連する図の取得が示されています。

このサンプルで、ターゲット DSL の名前は StateMachine です。そこから、モデルクラスの名前や ModelBusAdapter の名前など、いくつかの名前が派生しています。

using Fabrikam.StateMachine.ModelBusAdapters; 
using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Diagrams;
using Microsoft.VisualStudio.Modeling.Integration;
using Microsoft.VisualStudio.Modeling.Integration.Shell;
using Microsoft.VisualStudio.Modeling.Shell;
...
// Create a new model.
ModelBusReference modelReference = 
   StateMachineAdapterManager    .CreateStateMachineModel(modelName, fileName);
//Keep reference of new model in this model.
using (Transaction t = ...)
{
  myModelElement.ReferenceProperty = modelReference;
  t.Commit();
}
// Get the ModelBus service from Visual Studio.
IModelBus modelBus = Microsoft.VisualStudio.Shell.Package.
    GetGlobalService(typeof(SModelBus)) as IModelBus;
// Get a modelbus adapter on the new model.
ModelBusAdapter modelBusAdapter;
modelBus.TryCreateAdapter(modelReference, 
    this.ServiceProvider, out modelBusAdapter);
using (StateMachineAdapter adapter = 
      modelBusAdapter as StateMachineAdapter)
{
    if (adapter != null)
    {
        // Obtain a Diagram from the adapter.
        Diagram targetDiagram = 
           ((StandardVsModelingDiagramView)
                 adapter.GetDefaultView()
            ).Diagram;

        using (Transaction t = 
             targetDiagram.Store.TransactionManager
                .BeginTransaction("Update diagram"))
        {
            DoUpdates(targetDiagram);
            t.Commit();
        }

        // Display the new diagram.
        adapter.GetDefaultView().Show();
    }
}

参照の検証

BrokenReferenceDetector は ModelBusReferences を保持可能な、Store 内のすべてのドメインプロパティをテストします。これはアクションが見つかった場所で指定されるアクションを呼び出します。これは特に検証メソッドに便利です。次の検証メソッドは、モデルの保存を試行するときにストアをテストし、壊れている参照をエラーウィンドウに報告します。

[ValidationMethod(ValidationCategories.Save)]
public void ValidateModelBusReferences(ValidationContext context)
{
  BrokenReferenceDetector.DetectBrokenReferences(this.Store,
    delegate(ModelElement element, // parent of property
             DomainPropertyInfo property, // identifies property
             ModelBusReference reference) // invalid reference
    { 
      context.LogError(string.Format(INVALID_REF_FORMAT, 
             property.Name, 
             referenceState.Name, 
             new ModelBusReferenceTypeConverter().
                 ConvertToInvariantString(reference)), 
         "Reference", 
         element);
      });
}}
private const string INVALID_REF_FORMAT = 
    "The '{0}' domain property of ths ReferenceState instance "
  + "named '{1}' contains reference value '{2}' which is invalid";

ModelBus 拡張機能により実行されるアクション

次の情報は必須ではありませんが、ModelBus を広く使用する場合に有用な場合があります。

ModelBus 拡張機能は DSL ソリューションで次の変更を加えます。

DSL 定義図を右クリックし、[Modelbus の有効化] をクリックして、[この DSL が ModelBus を利用可能にする] を選択する場合:

DSL プロジェクトで、Microsoft.VisualStudio.Modeling.Sdk.Integration.11.0.dll に参照が追加されます。
DSL 定義に、外部型参照 Microsoft.VisualStudio.Modeling.Integration.ModelBusReference が追加されます。

参照は DSL エクスプローラー の [ドメイン型] の下で確認できます。外部型参照を手動で追加するには、ルートノードを右クリックします。
新しいテンプレートファイル Dsl\GeneratedCode\ModelBusReferencesSerialization.tt が追加されます。

ModelBusReference ドメインプロパティの型を設定した後、プロパティを右クリックして [ModelBusReference 固有プロパティの有効化] をクリックする場合:

ドメインプロパティにいくつかの CLR 属性が追加されます。それらはプロパティウィンドウの Custom Attributes フィールドで確認できます。 Dsl\GeneratedCode\DomainClasses.cs で、次のように、プロパティ宣言上の属性を確認できます。

[System.ComponentModel.TypeConverter(typeof(
Microsoft.VisualStudio.Modeling.Integration.ModelBusReferenceTypeConverter))]
[System.ComponentModel.Editor(typeof(
  Microsoft.VisualStudio.Modeling.Integration.Picker
  .ModelReferenceEditor // or ModelElementReferenceEditor
  ), typeof(System.Drawing.Design.UITypeEditor))]
[Microsoft.VisualStudio.Modeling.Integration.Picker
  .SupplyFileBasedBrowserConfiguration
  ("Choose a model file", "Target model|*.target")]

DSL 定義図を右クリックし、[Modelbus の有効化] をクリックして、[この DSL を ModelBus に公開する] を選択する場合:

ソリューションに新しいプロジェクト ModelBusAdapter が追加されます。
DslPackage プロジェクトに ModelBusAdapter への参照が追加されます。 ModelBusAdapter は Dsl プロジェクトへの参照を持ちます。
DslPackage\source.extention.tt で、MEF コンポーネントとして |ModelBusAdapter| が追加されます。

参照

概念

方法: プログラムコード内のファイルからモデルを開く

方法: UML モデルを他のモデルおよびツールと統合する

方法: ドラッグアンドドロップハンドラーを追加する

テキストテンプレートでの Visual Studio ModelBus の使用

次の方法で共有

Visual Studio Modelbus によるモデルの統合

DSL へのアクセスの提供

DSL 定義をモデルバスに公開するには

要素が参照可能であることの確認

要素 ID が保持されることを確認するには

別の DSL からの DSL のアクセス

DSL が公開されている DSL への参照を利用可能にするには

モデルバス参照をドメインプロパティに保存するには

ユーザーがモデルバス参照をドメインプロパティに設定可能にするには

モデルバス参照をテストするには

プログラムコード中の参照の作成

公開されている DSL アセンブリのインポート

モデルへの参照を作成するには

要素への参照を作成するには

参照の解決

テキストテンプレート内の ModelBus References を解決するには

ModelBusReference のシリアル化

指定されたファイルパスを基準とする相対シリアル化

他のアダプターにより作成された ModelBusReferences

モデルを作成するには

モデルの作成、オープン、および編集

参照の検証

ModelBus 拡張機能により実行されるアクション

参照

概念

その他のリソース

次の方法で共有

Visual Studio Modelbus によるモデルの統合

DSL へのアクセスの提供

DSL 定義をモデル バスに公開するには

要素が参照可能であることの確認

要素 ID が保持されることを確認するには

別の DSL からの DSL のアクセス

DSL が公開されている DSL への参照を利用可能にするには

モデル バス参照をドメイン プロパティに保存するには

ユーザーがモデル バス参照をドメイン プロパティに設定可能にするには

モデル バス参照をテストするには

プログラム コード中の参照の作成

公開されている DSL アセンブリのインポート

モデルへの参照を作成するには

要素への参照を作成するには

参照の解決

テキスト テンプレート内の ModelBus References を解決するには

ModelBusReference のシリアル化

指定されたファイル パスを基準とする相対シリアル化

他のアダプターにより作成された ModelBusReferences

モデルを作成するには

モデルの作成、オープン、および編集

参照の検証

ModelBus 拡張機能により実行されるアクション

参照

概念

その他のリソース

DSL 定義をモデルバスに公開するには

モデルバス参照をドメインプロパティに保存するには

ユーザーがモデルバス参照をドメインプロパティに設定可能にするには

モデルバス参照をテストするには

プログラムコード中の参照の作成

テキストテンプレート内の ModelBus References を解決するには

指定されたファイルパスを基準とする相対シリアル化