Postupy: Vytvoření vlastního editoru dat pro adaptér diagnostických dat

Článek
06/10/2015

Při vytváření adaptéru diagnostických dat můžete uživateli povolit konfiguraci určitých dat při výběru vlastního adaptéru diagnostických dat pro nastavení jejich testu.Například můžete vybrat konfigurační data, která určují, které klíče registru chcete extrahovat, jakou úroveň zatížení sítě chcete simulovat nebo ve kterém adresáři chcete hledat dočasné soubory nebo pracovní soubory pro připojení.

Konfigurační soubor musí použít k nastavení počátečních hodnot pro adaptér diagnostických dat.Můžete poskytnout vlastní editor umožňující uživateli upravit konfigurační data.

Chcete-li vytvořit vlastní editor, vytvoříte uživatelský ovládací prvek, který implementuje IDataCollectorConfigurationEditor.

Váš adaptér diagnostických dat může používat DataCollectorConfigurationEditorAttribute k určení třídy editor pro úpravu nastavení konfigurace diagnostických dat.

Můžete také určit výchozí konfigurační data, která chcete použít. Vzorová výchozí konfigurace viz Ukázkový projekt pro vytvoření adaptéru diagnostických dat.

Pomocí následujícího postupu vytvořte vlastní editor k aktualizaci dat pro nastavení testu při použití vlastního adaptéru diagnostických dat.

[!POZNÁMKA]

Chcete-li vytvořit vlastní editor, je nutné nejprve vytvořit adaptér diagnostických dat, který má DataCollectorConfigurationEditorAttribute aplikován na třídu.Můžete použít nepovinnou vlastnost HelpUri v tomto atributu k určení zdroje obsahu nápovědy pro editor.Další informace o vytváření adaptéru diagnostických dat naleznete v tématu Postupy: Vytvoření adaptéru diagnostických dat.

Kompletní příklad diagnostických dat adaptéru projektu, včetně vlastního konfiguračního editoru, naleznete v Ukázkový projekt pro vytvoření adaptéru diagnostických dat.

Vytvoření vlastního editoru pro adaptér diagnostických dat.

Vytvoření vlastního editoru pro adaptér diagnostických dat

Vytvoření uživatelského ovládacího prvku v projektu pro adaptér diagnostických dat:
1. Klepněte pravým tlačítkem na kód projektu, který obsahuje třídu adaptéru pro diagnostická data, přejděte na možnost Přidat a poté na možnost Uživatelský ovládací prvek.
2. V tomto příkladu přidejte popisek do formuláře s tímto textem: Název datového souboru: a textové pole s názvem FileTextBox, které umožní uživateli zadat potřebné údaje.
[!POZNÁMKA]

Podporovány jsou aktuálně pouze uživatelské ovládací prvky Windows Forms.

Přidáte tyto řádky do části deklarace:

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

Převeďte tento uživatelský ovládací prvek na vlastní editor.
1. Klepněte pravým tlačítkem na uživatelský ovládací prvek v projektu kódu a přejděte na možnost Zobrazit kód.
2. Nastavení třídu pro implementaci rozhraní editoru IDataCollectorConfigurationEditor takto:
```
   public partial class MyDataConfigEditor :
        UserControl, IDataCollectorConfigurationEditor
```
1. Klepněte pravým tlačítkem na možnost IDataCollectorConfigurationEditor v kódu a vyberte příkaz Implementovat rozhraní.Metody, které je nutné implementovat pro toto rozhraní, budou přidány do vaší třídy.
2. Přidat DataCollectorConfigurationEditorAttribute do svého uživatelského ovládacího prvku pro editor k jeho identifikaci jako editoru adaptéru diagnostických dat, čímž nahradíte pole Společnost, Produkt a Verze odpovídajícími informacemi pro adaptér diagnostických dat:
```
[DataCollectorConfigurationEditorTypeUri(
    "configurationeditor://MyCompany/MyConfigEditor/1.0")]
```

Přidejte dvě soukromé proměnné následujícím způsobem:

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

Přidáte kód pro inicializaci editoru pro adaptér diagnostických dat.Výchozí hodnoty pro pole můžete přidat do svého uživatelského ovládacího prvku pomocí dat, která jsou v nastavení proměnné.To jsou data, která jsou v elementu <DefaultConfiguration> v konfiguračním souboru XML pro adaptér.

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();
}

Přidejte kód pro uložení dat z ovládacích prvků v editoru zpět do formátu XML požadovaného rozhraním API adaptéru diagnostických dat adaptéru následujícím způsobem:

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

Pokud je to pro vás důležité, přidejte kód pro ověření správnosti dat v metodě VerifyData nebo může metoda vrátit true.
```
public bool VerifyData()
{
    // Not currently verifying data
    return true;
}
```

(Volitelné) Můžete přidat kód k obnovení dat do původního nastavení, které je k dispozici v konfiguračním souboru XML v metodě ResetToAgentDefaults(), která používá soukromou metodu 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;
}

Sestavte řešení.Zkopírujte sestavení adaptéru diagnostických dat a konfigurační soubor XML (<diagnostic data adapter name>.dll.config) do následujícího umístění založeného na instalačním adresáři: Program Files\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssemblies\DataCollectors.

[!POZNÁMKA]

Přestože editor konfigurace může být v projektu a sestavení, které se liší od adaptéru diagnostických dat, může také být ve stejném sestavení.
Pokud chcete použít při testování adaptér diagnostických dat, musíte ze seznamu vybrat existující nastavení testu nebo vytvořit nové z aplikace Microsoft Test Manager nebo Visual Studio a vybrat adaptér diagnostických dat.

Adaptér se zobrazí na kartě Data a diagnostika ve vašem nastavení testu s popisným názvem, který jste přiřadili do třídy.
Při konfiguraci adaptéru diagnostických dat pro nastavení testu zvolte Konfigurovat vedle názvu adaptéru.

Vlastní editor je nyní zobrazen.
Upravte pole ve vlastním editoru podle potřeby a potom zvolte Uložit.
Pokud spouštíte testy z Microsoft Test Manager, můžete přiřadit tato nastavení testu do plánu testování před spuštěním testů nebo pomocí příkazu Spustit s možnostmi pro přidělení nastavení testu a přepsání nastavení testu.Další informace o nastaveních testu naleznete v části Nastavení počítačů a shromažďování diagnostických informací s použitím nastavení testu.
Než budete moci použít vaši novou konfiguraci editoru s adaptérem diagnostických dat, je třeba použít DataCollectorConfigurationEditorAttribute pro každou třídu adaptéru diagnostických dat, kterou má použít editor a poté je znovu zkompilovat a znovu nainstalovat do klientského počítače.Další informace o tom, jak nainstalovat adaptéry diagnostických dat a konfigurační editory, naleznete v tématu Postupy: Instalace vlastního adaptéru diagnostických dat.
Spusťte testy pomocí nastavení testu společně s výběrem adaptéru diagnostiky datu.

K výsledkům testů je připojen datový soubor, který jste zadali v editoru.

Další informace o konfiguraci nastavení testu na použití prostředí při spuštění testů naleznete v tématu Shromažďování více diagnostických dat v manuálních testech nebo Vytváření nastavení testů pro automatizované systémové testy pomocí nástroje Microsoft Test Manager.

Viz také

Sdílet prostřednictvím

Postupy: Vytvoření vlastního editoru dat pro adaptér diagnostických dat

Vytvoření vlastního editoru pro adaptér diagnostických dat.

Vytvoření vlastního editoru pro adaptér diagnostických dat

Viz také

Úkoly

Referenční dokumentace

Koncepty

Další materiály