Procedura: creare un editor personalizzato di dati per l'adattatore dati di diagnostica in uso

Articolo
08/11/2011

Quando si crea un adattatore dati di diagnostica, potrebbe essere necessario consentire all'utente di configurare dati specifici quando l'adattatore dati di diagnostica personalizzato è selezionato per le relative impostazioni di test. È possibile, ad esempio, selezionare i dati di configurazione che specificano le chiavi del Registro di sistema da estrarre, il livello di carico di rete da simulare o la directory in cui trovare file temporanei o file di lavoro da allegare.

È necessario utilizzare un file di configurazione per configurare i valori iniziali per l'adattatore dati di diagnostica. È possibile fornire un editor personalizzato per consentire all'utente di modificare i dati di configurazione.

Per creare un editor personalizzato, è necessario creare un controllo utente che implementa IDataCollectorConfigurationEditor.

L'adattatore dati di diagnostica può utilizzare un oggetto DataCollectorConfigurationEditorAttribute per specificare la classe dell'editor da utilizzare per la modifica delle impostazioni di configurazione dei dati di diagnostica.

Specificare inoltre i dati di configurazione predefiniti che si desidera utilizzare. Per un esempio di configurazione predefinita, vedere Esempio di progetto per creare un adattatore dati di diagnostica.

Utilizzare la procedura seguente per creare un editor personalizzato per aggiornare i dati per le impostazioni di test quando si utilizza l'adattatore dati di diagnostica personalizzato.

Nota

Per creare un editor personalizzato, è innanzitutto necessario creare l'adattatore dati di diagnostica con l'oggetto DataCollectorConfigurationEditorAttribute applicato alla classe. È possibile utilizzare la proprietà HelpUri facoltativa in tale attributo per specificare l'origine del contenuto della Guida per l'editor. Per ulteriori informazioni su come creare l'adattatore dati di diagnostica, vedere Procedura: creare un adattatore dati di diagnostica.

Per un progetto di adattatore dati di diagnostica di esempio completo, incluso un editor di configurazione personalizzato, vedere Esempio di progetto per creare un adattatore dati di diagnostica.

Creazione di un editor personalizzato per l'adattatore dati di diagnostica

Per creare un editor personalizzato per l'adattatore dati di diagnostica

Creare un controllo utente nel progetto per l'adattatore dati di diagnostica:
1. Fare clic con il pulsante destro del mouse sul progetto codice che contiene la classe dell'adattatore dati di diagnostica, scegliere Aggiungi, quindi Controllo utente.
2. Per questo esempio, aggiungere un'etichetta al form con il testo indicante il nome del file di dati e una casella di testo denominata FileTextBox, per consentire all'utente di immettere i dati necessari.
Nota

Sono attualmente supportati solo i controlli utente Windows Form.

Aggiungere queste righe alla sezione della dichiarazione:

using System.Xml;
using Microsoft.VisualStudio.TestTools.Common;
using Microsoft.VisualStudio.TestTools.Execution;

Creare il controllo utente in un editor personalizzato.
1. Fare clic con il pulsante destro del mouse sul controllo utente nel progetto codice, quindi scegliere Visualizza codice.
2. Impostare la classe per implementare l'interfaccia dell'editor IDataCollectorConfigurationEditor come indicato di seguito:
```
   public partial class MyDataConfigEditor :
        UserControl, IDataCollectorConfigurationEditor
```
1. Fare clic con il pulsante destro del mouse su IDataCollectorConfigurationEditor nel codice e scegliere il comando Implementa interfaccia. I metodi che è necessario implementare per l'interfaccia verranno aggiunti alla classe.
2. Aggiungere DataCollectorConfigurationEditorAttribute al controllo utente per l'editor in modo che venga identificato come editor dell'adattatore dati di diagnostica, sostituendo Società, Prodotto e Versione con le informazioni appropriate per l'adattatore dati di diagnostica:
```
[DataCollectorConfigurationEditorTypeUri(
    "configurationeditor://MyCompany/MyConfigEditor/1.0")]
```

Aggiungere due variabili private come segue:

private DataCollectorSettings collectorSettings;
private IServiceProvider ServiceProvider { get; set; }

Aggiungere il codice per inizializzare l'editor per l'adattatore dati di diagnostica. È possibile aggiungere valori predefiniti ai campi nel controllo utente utilizzando dati nella variabile delle impostazioni. Si tratta dei dati presenti nell'elemento <DefaultConfiguration> del file di configurazione XML per l'adattatore.

public void Initialize(
    IServiceProvider svcProvider,
    DataCollectorSettings settings)
{
    ServiceProvider = svcProvider;
    collectorSettings = settings;

    // Display the default file name as listed in the settings file.
    this.SuspendLayout();
    this.FileTextBox.Text = getText(collectorSettings.Configuration);
    this.ResumeLayout();
}

Aggiungere il codice per salvare nuovamente i dati dai controlli nell'editor nel formato XML richiesto dall'API dell'adattatore dati di diagnostica, come indicato di seguito:

public DataCollectorSettings SaveData()
{
    collectorSettings.Configuration.InnerXml =
        String.Format(
@"<MyCollectorName
    http://MyCompany/schemas/MyDiagnosticDataCollector/1.0"">
  <File FullPath=""{0}"" />
</MyCollectorName>",
    FileTextBox.Text);
    return collectorSettings;
}

Se lo si desidera, aggiungere il codice per verificare che i dati siano corretti nel metodo VerifyData. In alternativa, è possibile fare in modo che il metodo restituisca true.
```
public bool VerifyData()
{
    // Not currently verifying data
    return true;
}
```

(Facoltativo) È possibile aggiungere codice per ripristinare in base alle impostazioni iniziali i dati forniti nel file di configurazione XML nel metodo ResetToAgentDefaults(), che utilizza il metodo privato getText().

// Reset to default value from XML configuration
// using a custom getText() method
public void ResetToAgentDefaults()
{
    this.FileTextBox.Text = getText(collectorSettings.DefaultConfiguration);
}

// Local method to read the configuration settings
private string getText(XmlElement element)
{
    // Setup namespace manager with our namespace
    XmlNamespaceManager nsmgr =
        new XmlNamespaceManager(
            element.OwnerDocument.NameTable);

    // Find all the "File" elements under our configuration
    XmlNodeList files = element.SelectNodes("//ns:MyCollectorName/ns:File", nsmgr);

    string result = String.Empty;
    if (files.Count > 0)
    {
        XmlAttribute pathAttribute = files[0].Attributes["FullPath"];
        if (pathAttribute != null &&
            !String.IsNullOrEmpty(pathAttribute.Value))
        {
            result = pathAttribute.Value;
        }
    }

    return result;
}

Compilare la soluzione. Copiare l'assembly dell'adattatore dati di diagnostica e il file di configurazione XML (<diagnostic data adapter name>.dll.config) nel percorso seguente, in base alla directory di installazione: Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies\DataCollectors.

Nota

Sebbene l'editor di configurazione possa trovarsi in un progetto e in un assembly diversi dall'adattatore dati di diagnostica, è anche possibile che si trovino nello stesso assembly.
Per utilizzare l'adattatore dati di diagnostica nei test, è necessario selezionarlo nell'elenco delle impostazioni di test esistenti oppure crearne uno nuovo da Microsoft Test Manager o Microsoft Visual Studio 2010 e quindi selezionarlo.

L'adattatore verrà visualizzato nella scheda Dati e diagnostica delle impostazioni di test con il nome descrittivo assegnato alla classe.
Per configurare l'adattatore dati di diagnostica per le impostazioni di test, fare clic su Configura accanto al nome dell'adattatore.

Verrà visualizzato l'editor personalizzato.
Modificare come richiesto i campi nell'editor personalizzato, quindi fa clic su Salva.
Se i test vengono eseguiti da Microsoft Test Manager, è possibile assegnare queste impostazioni di test al piano di test prima di eseguire i test oppure utilizzare il comando Esegui con opzioni per assegnare impostazioni di test ed eseguire l'override delle impostazioni di test. Per ulteriori informazioni sulle impostazioni di test, vedere Configurazione di computer e raccolta di informazioni diagnostiche mediante impostazioni test.
Per poter utilizzare il nuovo editor di configurazione con un adattatore dati di diagnostica, è necessario applicare DataCollectorConfigurationEditorAttribute a ogni classe dell'adattatore dati di diagnostica con cui si desidera utilizzare l'editor, quindi ricompilarli e reinstallarli nel computer client. Per ulteriori informazioni sull'installazione di adattatori dati di diagnostica e di editor di configurazione, vedere Procedura: installare un adattatore dati di diagnostica personalizzato.
Eseguire i test utilizzando le impostazioni di test con l'adattatore dati di diagnostica selezionato.

Il file di dati specificato nell'editor verrà allegato ai risultati del test.

Per ulteriori informazioni sulla configurazione delle impostazioni di test per utilizzare un ambiente quando si eseguono i test, vedere Creazione di impostazioni di test per test manuali o Creazione di impostazioni di test per test automatizzati come parte di un piano di test.

Vedere anche

Condividi tramite

Procedura: creare un editor personalizzato di dati per l'adattatore dati di diagnostica in uso

Creazione di un editor personalizzato per l'adattatore dati di diagnostica

Per creare un editor personalizzato per l'adattatore dati di diagnostica

Vedere anche

Attività

Riferimenti

Concetti

Risorse aggiuntive