Gewusst wie: Erstellen von benutzerdefinierten Daten-Generatoren

Benutzerdefinierte Datengeneratoren sind Komponenten, die vom Datengenerator zum Erzeugen von Daten in Datengenerierungsplänen verwendet werden können. Obwohl der Datengenerator mehrere vordefinierte Generatoren enthält, empfiehlt es sich, benutzerdefinierte Datengeneratoren speziell für Ihre Anforderungen zu erstellen.

In diesem Thema wird beschrieben, wie ein benutzerdefinierter Datengenerator mit normaler Erweiterbarkeit erstellt wird. In den meisten Fällen empfiehlt sich die Verwendung von normaler Erweiterbarkeit. Sie können benutzerdefinierte Datengeneratoren auch mit anderen Verfahren, einschließlich deklarativer Erweiterbarkeit, Aggregationserweiterbarkeit und Basiserweiterbarkeit, erstellen. Weitere Informationen finden Sie unter Übersicht über die Erweiterbarkeit von Daten-Generatoren.

So erstellen Sie einen benutzerdefinierten Datengenerator

1. Erstellen Sie ein Klassenbibliotheksprojekt.

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und klicken Sie dann auf Verweis hinzufügen.

   Das Dialogfeld Verweis hinzufügen wird angezeigt.

3. Klicken Sie auf die Registerkarte .NET. Klicken Sie in der Liste Komponentenname auf Microsoft.Data.Schema und anschließend auf OK.

4. (Optional, nur Visual Basic) Klicken Sie im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen, und erweitern Sie den Knoten Verweise, um den neuen Verweis zu überprüfen.

5. Fügen Sie oben im Codefenster vor der Klassendeklaration die folgende Codezeile hinzu:

   Microsoft.Data.Schema.Tools.DataGenerator
   

   Microsoft.Data.Schema.Tools.DataGenerator;
   

6. Benennen Sie die Klasse von Class1 in den gewünschten Namen um.

   Warnung

   Der Name, den Sie für die Klasse festlegen, wird standardmäßig im Fenster Spaltendetails in der Liste der Spalte Generator angezeigt. Legen Sie einen Namen fest, der zu keinem Konflikt mit dem Namen eines Standardgenerators oder dem Namen eines anderen benutzerdefinierten Generators führt. Weitere Informationen finden Sie unter Überlegungen zu benutzerdefinierten Daten-Generatoren.

   Public Class YourGeneratorName
   
   End Class
   

   public class YourGeneratorName
   {
   }
   

7. Geben Sie an, dass die Klasse von Generator erbt, wie im folgenden Beispiel gezeigt:

   Public Class YourGeneratorName
       Inherits Generator
   
   End Class
   

   public class YourGeneratorName: Generator
   {
   }
   

8. (Optional) Fügen Sie der Klassendeklaration das GeneratorStylesAttribute hinzu.

   Wichtig

   Wenn der benutzerdefinierte Datengenerator der Standarddatengenerator für einen Spaltentyp sein soll, muss er eindeutige Werte erzeugen, und Sie müssen der Klasse das GeneratorStylesAttribute hinzufügen. Weitere Informationen finden Sie unter Gewusst wie: Ändern des Standard-Generators für einen Spaltentyp.

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

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

9. (Optional) Fügen Sie der Klassendeklaration das GeneratorAttribute hinzu.

   Warnung

   Fügen Sie das Attribut der Klasse nur dann hinzu, wenn Sie einen benutzerdefinierten Designertyp für den benutzerdefinierten Datengenerator angeben möchten. Wenn Sie keinen benutzerdefinierten Designertyp angeben möchten, können Sie dieses Attribut auslassen, und es wird automatisch der Standarddesigner verwendet.

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

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

10. Fügen Sie mindestens eine Ausgabeeigenschaft hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Ausgabeeigenschaften zu einem Daten-Generator.

11. Fügen Sie bei Bedarf Eingabeeigenschaften hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Eingabeeigenschaften zu einem Daten-Generator.

12. Implementieren Sie die OnGenerateNextValues-Methode, um entsprechende Werte für jede Ausgabeeigenschaft zu generieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Daten-Generators.

13. Signieren Sie die Assembly mit einem starkem Namen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Daten-Generators.

14. Erstellen Sie die Projektmappe.

15. Registrieren Sie den neuen Generator in Visual Studio. Weitere Informationen finden Sie unter Gewusst wie: Registrieren und Verwalten von Funktionserweiterungen und unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Daten-Generators.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Daten-Generators

Konzepte

Generieren spezialisierter Testdaten mit einem benutzerdefinierten Daten-Generator