Gewusst wie: Erstellen von benutzerdefinierten Datengeneratoren

Aktualisiert: November 2007

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 Datengeneratoren.

So erstellen Sie einen benutzerdefinierten Generator

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 der Registerkarte .NET in der Liste Komponentenname auf Microsoft.VisualStudio.TeamSystem.Data 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:

   Imports Microsoft.VisualStudio.TeamSystem.Data.DataGenerator
   

   using Microsoft.VisualStudio.TeamSystem.Data.DataGenerator;
   

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

   Vorsicht:
   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 eines anderen benutzerdefinierten Generators führt. Weitere Informationen finden Sie unter Überlegungen zu benutzerdefinierten Datengeneratoren.

   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.

   Wichtiger Hinweis:
   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 Standardgenerators 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.

   Vorsicht:
   Sie müssen der Klasse das GeneratorAttribute nur hinzufügen, wenn Sie einen benutzerdefinierten Designertyp für den benutzerdefinierten Datengenerator angeben möchten. Wenn Sie keinen benutzerdefinierten Designer 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 Datengenerator.

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

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 Datengenerators.

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

14. Erstellen Sie die Projektmappe.

15. Registrieren Sie den neuen Generator in Visual Studio. Weitere Informationen finden Sie unter Gewusst wie: Registrieren von benutzerdefinierten Datengeneratoren.

Sicherheit

Weitere Informationen finden Sie unter Sicherheit von Datengeneratoren.

Siehe auch

Weitere Ressourcen

Erstellen von benutzerdefinierten Datengeneratoren

Exemplarische Vorgehensweisen für den Datengenerator