Procedura: creare generatori di dati personalizzati

I generatori di dati personalizzati sono componenti utilizzabili dalla funzionalità Generatore di dati per generare dati nei piani di generazione dati. Sebbene nella funzionalità Generatore di dati siano inclusi diversi generatori preimpostati, potrebbe essere utile creare generatori personalizzati per esigenze specifiche.

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

Per creare un generatore di dati personalizzato

  1. Creare un progetto Libreria di classi.

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

    Verrà visualizzata la finestra di dialogo Aggiungi riferimento.

  3. Fare clic sulla scheda .NET. Nell'elenco Nome componente fare clic su Microsoft.Data.Schema, quindi scegliere OK.

  4. (Facoltativo, solo in Visual Basic) In Esplora soluzioni fare clic sul 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:

    Microsoft.Data.Schema.Tools.DataGenerator
    
    Microsoft.Data.Schema.Tools.DataGenerator;
    
  6. Rinominare la classe Class1 specificando il nome desiderato.

    Nota di avvisoAttenzione

    Per impostazione predefinita, il nome assegnato alla classe sarà 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 importanteImportante

    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.

    Nota di avvisoAttenzione

    Aggiungere questo attributo alla dichiarazione della classe solo se si desidera specificare un tipo di finestra di progettazione personalizzato per il generatore di dati personalizzato. Se non si desidera specificare un tipo di finestra di progettazione personalizzato, è 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. Compilare la soluzione.

  15. Registrare il nuovo generatore con Visual Studio. Per ulteriori informazioni, vedere Procedura: registrare e gestire estensioni di funzionalità e Procedura dettagliata: creazione di un generatore dati personalizzato.

Vedere anche

Attività

Procedura dettagliata: creazione di un generatore dati personalizzato

Concetti

Generare dati di test specializzati con un generatore di dati personalizzato