HOW TO：建立自訂資料產生器

自訂資料產生器是「資料產生器」功能用來在「資料產生計劃」(Data Generation Plan) 中產生資料的元件。 雖然「資料產生器」功能提供了數個預設的產生器，但是您可能會想要建立自訂產生器來符合您的特定需求。

這個主題描述如何使用典型擴充性來建立自訂資料產生器。 在大多數情況下，典型擴充性是建議使用的方法。 您也可以使用其他方法來建立自訂資料產生器，包括宣告式擴充性、彙總擴充性及基底擴充性。 如需詳細資訊，請參閱資料產生器擴充性概觀。

若要建立自訂資料產生器

1. 建立類別庫專案。

2. 在 [方案總管] 中，以滑鼠右鍵按一下專案，然後按一下 [加入參考]。

   [加入參考] 對話方塊隨即出現。

3. 按一下 [.NET] 索引標籤。 在 [元件名稱] 清單中，按一下 [Microsoft.Data.Schema]，然後按一下 [確定]。

4. (選擇項，僅限 Visual Basic) 在 [方案總管] 中，按一下 [顯示所有檔案] 按鈕，並展開 [參考] 節點來驗證新的參考。

5. 在 [程式碼] 視窗上方的類別宣告之前，加入以下程式碼行：

   Microsoft.Data.Schema.Tools.DataGenerator
   

   Microsoft.Data.Schema.Tools.DataGenerator;
   

6. 將此類別從 Class1 重新命名為您想要的名稱。

   警告

   根據預設，您提供給類別的名稱為 [資料行詳細資料] 視窗中，出現在 [產生器] 資料行中清單內的名稱。 您應該指定不會與標準產生器名稱或另一個自訂產生器名稱發生衝突的名稱。 如需詳細資訊，請參閱自訂資料產生器的考量。

   Public Class YourGeneratorName
   
   End Class
   

   public class YourGeneratorName
   {
   }
   

7. 指定您的類別繼承自 Generator，如下列範例所示：

   Public Class YourGeneratorName
       Inherits Generator
   
   End Class
   

   public class YourGeneratorName: Generator
   {
   }
   

8. (選擇項) 將 GeneratorStylesAttribute 加入至類別宣告。

   重要事項
   如果您希望自訂資料產生器成為某個資料行型別的預設資料產生器，它必須要產生唯一的值，而且您必須將 GeneratorStylesAttribute 加入到此類別中。 如需詳細資訊，請參閱 HOW TO：變更資料行型別的預設產生器。

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

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

9. (選擇性) 將 GeneratorAttribute 加入至類別宣告。

   警告

   僅當您要指定自訂資料產生器的自訂設計工具類型時，才可將此屬性加入至類別宣告。 如果您不想要指定自訂設計工具類型，請省略這個屬性，就會自動使用預設設計工具。

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

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

10. 至少加入一個輸出屬性。 如需詳細資訊，請參閱 HOW TO：將輸出屬性加入至資料產生器。

11. 必要時，加入輸入屬性。 如需詳細資訊，請參閱 HOW TO：新增輸入屬性至資料產生器。

12. 實作 OnGenerateNextValues 方法來針對每一個輸出屬性產生適當的值。 如需詳細資訊，請參閱逐步解說：建立自訂資料產生器。

13. 使用強式名稱簽署組件。 如需詳細資訊，請參閱逐步解說：建立自訂資料產生器。

14. 建置方案。

15. 向 Visual Studio 註冊新的產生器。 如需詳細資訊，請參閱 HOW TO：註冊和管理功能擴充和逐步解說：建立自訂資料產生器。

請參閱

工作

逐步解說：建立自訂資料產生器

概念

使用自訂資料產生器產生特製化測試資料