方法 : カスタムデータジェネレータを作成する

2008-10-22

カスタムデータジェネレータは、データ生成計画でデータを生成するためにデータジェネレータ機能によって使用されるコンポーネントです。データジェネレータ機能には、設定済みのジェネレータが複数用意されていますが、特定のニーズに合うカスタムジェネレータを作成することが必要になる場合があります。

このトピックでは、典型的な機能拡張を使用してカスタムデータジェネレータを作成する方法について説明します。ほとんどの場合は、典型的な機能拡張を使用する方法をお勧めします。宣言機能拡張、集約機能拡張、基本機能拡張などの他の方法を使用して、カスタムデータジェネレータを作成することもできます。詳細については、「データジェネレータ機能拡張の概要」を参照してください。

カスタムデータジェネレータを作成するには

クラスライブラリプロジェクトを作成します。
ソリューションエクスプローラで、プロジェクトを右クリックし、[参照の追加] をクリックします。

[参照の追加] ダイアログボックスが表示されます。
[.NET] タブをクリックします。[コンポーネント名] ボックスの一覧の [Microsoft.VisualStudio.TeamSystem.Data] をクリックし、[OK] をクリックします。
(省略可能、Visual Basic のみ) ソリューションエクスプローラで、[すべてのファイルを表示] をクリックし、[参照設定] ノードを展開して、新しい参照を確認します。
[コード] ウィンドウの一番上のクラス宣言の前に、次のコード行を追加します。
```
Imports Microsoft.Data.Schema.DataGenerator
```
```
using Microsoft.Data.Schema.DataGenerator;
```

クラスの名前を Class1 から適切な名前に変更します。

注意 :
既定では、クラス名として指定した名前は、[列の詳細] ウィンドウの [ジェネレータ] 列の一覧に表示されます。標準のジェネレータや他のカスタムジェネレータの名前と競合しない名前を指定してください。詳細については、「カスタムデータジェネレータの考慮事項」を参照してください。

Public Class YourGeneratorName

End Class

public class YourGeneratorName
{
}

次の例に示すように、Generator からのクラスの継承を指定します。

Public Class YourGeneratorName
    Inherits Generator

End Class

public class YourGeneratorName: Generator
{
}

(省略可能) クラス宣言に GeneratorStylesAttribute を追加します。

重要 :
作成したカスタムデータジェネレータを特定の種類の列で使用する既定のジェネレータにする場合は、ジェネレータが一意の値を生成する必要があり、クラスに GeneratorStylesAttribute を追加する必要があります。詳細については、「方法 : 列の種類に対応する既定のジェネレータを変更する」を参照してください。

作成したカスタムデータジェネレータを特定の種類の列で使用する既定のジェネレータにする場合は、ジェネレータが一意の値を生成する必要があり、クラスに GeneratorStylesAttribute を追加する必要があります。詳細については、「方法 : 列の種類に対応する既定のジェネレータを変更する」を参照してください。

<GeneratorStyles(DesignerStyles:=GeneratorDesignerStyles.CanProduceUniqueValues)> _
Public Class TestGenerator
    Inherits Generator

End Class

[GeneratorStyles(DesignerStyles = GeneratorDesignerStyles.CanProduceUniqueValues)]
public class TestGenerator:Generator
{
}

(省略可能) クラス宣言に GeneratorAttribute を追加します。

注意 :
この属性は、カスタムデータジェネレータに使用するカスタムデザイナの種類を指定する場合にのみ、クラス宣言に追加してください。カスタムデザイナの種類を指定しない場合は、この属性を省略できます。省略した場合は、自動的に既定のデザイナが使用されます。

<Generator(GetType(CustomDesignerType))> _
Public Class TestGenerator
    Inherits Generator

End Class

[Generator(typeof(CustomDesignerType))]
public class TestGenerator:Generator
{
}

出力プロパティを少なくとも 1 つ追加します。詳細については、「方法 : 出力プロパティをデータジェネレータに追加する」を参照してください。
必要に応じて、入力プロパティを追加します。詳細については、「方法 : 入力プロパティをデータジェネレータに追加する」を参照してください。
出力プロパティごとに適切な値を生成するために、OnGenerateNextValues メソッドを実装します。詳細については、「チュートリアル: カスタムデータジェネレータの作成」を参照してください。
アセンブリに厳密な名前で署名します。詳細については、「チュートリアル: カスタムデータジェネレータの作成」を参照してください。
ソリューションをビルドします。
新しいジェネレータを Visual Studio に登録します。詳細については、「方法 : カスタムデータジェネレータを登録する」および「チュートリアル: カスタムデータジェネレータの作成」を参照してください。

次の方法で共有

方法 : カスタム データ ジェネレータを作成する

カスタム データ ジェネレータを作成するには

参照

処理手順

その他の技術情報

その他のリソース

方法 : カスタムデータジェネレータを作成する

カスタムデータジェネレータを作成するには