Procedura: creare generatori di dati personalizzati

Aggiornamento: novembre 2007

I generatori di dati personalizzati sono componenti utilizzabili da Generatore di dati per generare dati in piani di generazione dati. Sebbene in Generatore di dati siano inclusi diversi generatori preimpostati, è possibile che si desideri creare generatori personalizzati per esigenze specifiche.

In questo argomento viene descritto come creare un generatore di dati personalizzato utilizzando l'extensibility normale. L'extensibility normale rappresenta il metodo consigliato nella maggior parte dei casi. È inoltre possibile utilizzare altri metodi per creare generatori di dati personalizzati, tra cui l'extensibility dichiarativa, l'extensibility dell'aggregazione e l'extensibility di base. Per ulteriori informazioni, vedere Cenni preliminari sulla extensibility dei generatori di dati.

Per creare un generatore personalizzato

1. Creare un progetto Libreria di classi.

2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Aggiungi riferimento.

   Verrà visualizzata la finestra di dialogo Aggiungi riferimento.

3. Fare clic sulla scheda .NET. Nell'elenco Nome componente selezionare Microsoft.VisualStudio.TeamSystem.Data, quindi scegliere OK.

4. (Facoltativo, solo Visual Basic) In Esplora soluzioni scegliere il pulsante Mostra tutti i file ed espandere il nodo Riferimenti per verificare il nuovo riferimento.

5. Nella parte superiore della finestra Codice aggiungere la seguente riga di codice prima della dichiarazione di classe:

   Imports Microsoft.VisualStudio.TeamSystem.Data.DataGenerator
   

   using Microsoft.VisualStudio.TeamSystem.Data.DataGenerator;
   

6. Rinominare la classe Class1 specificando il nome desiderato.

   Attenzione:
   Per impostazione predefinita, il nome assegnato alla classe è quello visualizzato nell'elenco della colonna Generatore nella finestra Dettagli colonna. È necessario specificare un nome non in conflitto con quello di un generatore standard o di un altro generatore personalizzato. Per ulteriori informazioni, vedere Considerazioni per i generatori di dati personalizzati.

   Public Class YourGeneratorName
   
   End Class
   

   public class YourGeneratorName
   {
   }
   

7. Specificare che la classe eredita da Generator, come illustrato nell'esempio seguente:

   Public Class YourGeneratorName
       Inherits Generator
   
   End Class
   

   public class YourGeneratorName: Generator
   {
   }
   

8. (Facoltativo) Aggiungere GeneratorStylesAttribute alla dichiarazione della classe.

   Nota importante:
   Per impostare come predefinito per un tipo di colonna un generatore di dati personalizzato, è necessario che produca valori univoci. È inoltre necessario aggiungere l'attributo GeneratorStylesAttribute alla classe. Per ulteriori informazioni, vedere Procedura: modificare il generatore predefinito per un tipo di colonna.

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

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

9. (Facoltativo) Aggiungere GeneratorAttribute alla dichiarazione della classe.

   Attenzione:
   È necessario aggiungere l'attributo GeneratorAttribute alla classe solo se si desidera specificare un tipo di finestra di progettazione personalizzata per il generatore di dati personalizzato. Se non si desidera specificare una finestra di progettazione personalizzata, è possibile omettere l'attributo. Verrà utilizzata automaticamente la finestra di progettazione predefinita.

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

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

10. Aggiungere almeno una proprietà di output. Per ulteriori informazioni, vedere Procedura: aggiungere proprietà di output a un generatore di dati.

11. Se necessario, aggiungere proprietà di input. Per ulteriori informazioni, vedere Procedura: aggiungere proprietà di input a un generatore di dati.

12. Implementare il metodo OnGenerateNextValues per generare i valori appropriati per ciascuna proprietà di output. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un generatore dati personalizzato.

13. Firmare l'assembly con un nome sicuro. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un generatore dati personalizzato.

14. Generare la soluzione.

15. Registrare il nuovo generatore con Visual Studio. Per ulteriori informazioni, vedere Procedura: registrare generatori di dati personalizzati.

Sicurezza

Per ulteriori informazioni, vedere Protezione dei generatori di dati.

Vedere anche

Altre risorse

Creazione di generatori di dati personalizzati

Procedure dettagliate per i generatori di dati