Jak: vytvoření Editor vlastních dat adaptéru diagnostických dat

Článek
03/04/2013

Při vytváření diagnostických dat adaptéru můžete nakonfigurovat specifická data při výběru jejich test nastavení adaptéru vlastní diagnostických dat uživatele.Můžete například vybrat konfigurační data, která určuje, které klíče registru extrahovat, jakou úroveň simulovat zatížení sítě nebo do kterého adresáře najít dočasné soubory nebo soubory připojit práce.

Nastavit počáteční hodnoty adaptéru diagnostických dat, musíte použít konfigurační soubor.Můžete poskytnout vlastní editor uživateli měnit konfigurační data.

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

Pomocí adaptéru diagnostických dat DataCollectorConfigurationEditorAttribute určit třídu editor pro úpravu nastavení konfigurace diagnostických dat.

Můžete také zadat výchozí konfigurační data, která chcete použít.Viz Ukázkový projekt pro vytvoření diagnostické datový adaptér pro konfiguraci výchozího vzorku.

Pomocí následujícího postupu vytvořte vlastní editor aktualizovat data pro test nastavení při použití adaptéru diagnostické vlastní data.

[!POZNÁMKA]

Chcete-li vytvořit vlastní editor, musíte nejprve vytvořit adaptéru diagnostických dat, který má DataCollectorConfigurationEditorAttribute pro třídu.Lze použít nepovinný HelpUri vlastnost v atributu určit zdroj obsahu nápovědy pro editor.Další informace o vytváření adaptéru diagnostických dat, viz Jak: Vytvoření diagnostické datový adaptér.

Adaptér projektu kompletní příklad diagnostických dat, včetně editoru vlastní konfigurace, viz Ukázkový projekt pro vytvoření diagnostické datový adaptér.

Vytvoření vlastní Editor diagnostických dat adaptéru

Vytvořit vlastní editor adaptéru diagnostických dat

Vytvořte ovládací prvek uživatele v projektu adaptéru diagnostických dat:
1. Klepněte pravým tlačítkem na kód projektu, který obsahuje třídy diagnostických dat adaptéru, přejděte na Přidat a potom přejděte na Uživatelský ovládací prvek.
2. Například přidání popisku do formuláře s tímto textem: název datového souboru: a textové pole s názvem FileTextBox, umožňující uživateli zadat potřebné údaje.
[!POZNÁMKA]

Podporována jsou pouze ovládací prvky uživatele model Windows Forms.

Přidáte tyto řádky do části prohlášení:

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

Tento ovládací prvek uživatele vytvořit vlastní editor.
1. Klepněte pravým tlačítkem na ovládací prvek uživatelského kódu projektu a přejděte na zobrazení kódu.
2. Nastavení třídy pro implementaci rozhraní editoru IDataCollectorConfigurationEditor takto:
```
   public partial class MyDataConfigEditor :
        UserControl, IDataCollectorConfigurationEditor
```
1. Pravým tlačítkem myši na IDataCollectorConfigurationEditor v kódu a vyberte Implementovat rozhraní příkaz.Metody, které musí implementovat toto rozhraní jsou přidány do třídy.
2. Přidat DataCollectorConfigurationEditorAttribute k ovládání uživatelem editoru identifikovat jako editor diagnostických dat adaptéru nahrazení společnosti, produkt, a verze odpovídající informace pro adaptér diagnostických dat:
```
[DataCollectorConfigurationEditorTypeUri(
    "configurationeditor://MyCompany/MyConfigEditor/1.0")]
```

Přidejte dvě soukromé proměnné:

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

Přidáte kód editor adaptéru diagnostických dat inicializovat.Můžete přidat výchozí hodnoty v polích s uživatelským ovládáním pomocí dat v nastavení proměnné.Toto je data v <DefaultConfiguration> prvku 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řidáte kód a data z ovládacích prvků v editoru uložit zpět do formátu XML, které jsou vyžadované adaptérem diagnostických dat API takto:

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 pro vás důležité, přidejte kód ověřit správnost dat v VerifyData metodou, nebo může mít metoda vrátí true.
```
public bool VerifyData()
{
    // Not currently verifying data
    return true;
}
```

(Volitelné) Můžete přidat kód data obnovit původní nastavení, které jsou k dispozici v konfiguračním souboru XML v ResetToAgentDefaults() metoda, která používá soukromé getText() metoda.

// 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í.Kopírovat diagnostický adaptér sestavení dat a konfigurační soubor XML (<diagnostic data adapter name>.dll.config) v následujícím umístění na základě instalačního adresáře: Program Files\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\DataCollectors.

[!POZNÁMKA]

Ačkoli editoru 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í.
Použít adaptér diagnostických dat v testování, vyberte ze seznamu existující test nastavení nebo vytvořit novou z Microsoft Test Manager nebo Visual Studio a vyberte adaptér diagnostických dat.

Adaptér je zobrazen na dat a Diagnostika kartu Nastavení testu s popisným názvem, který přiřazena třída.
Chcete-li konfigurovat adaptér diagnostických dat pro test nastavení, zvolte Konfigurace vedle názvu adaptéru.

Vlastní editor je nyní zobrazena.
Upravit v Editoru vlastních požadované pole a pak zvolte Uložit.
Pokud používáte testy z Microsoft Test Manager, můžete přiřadit tyto otestovat nastavení plánu před spustit testy nebo použít s možností test příkazu přiřadit test nastavení a přepsat nastavení.Další informace o nastavení testu viz Nastavení stroje a shromažďování diagnostických informací pomocí nastavení testu.
Než použijete editor nové konfigurace adaptéru diagnostických dat je třeba použít DataCollectorConfigurationEditorAttribute pro každou třídu adaptér diagnostických dat, kterou chcete použít editor a znovu zkompilujte a znovu v klientském počítači.Další informace o instalaci adaptérů diagnostických dat a konfigurace editory, viz Jak: Nainstalujte adaptér vlastní diagnostických dat.
Testy test nastavení pomocí adaptéru diagnostických dat vybrána.

Datový soubor, který jste zadali v editoru je připojen k výsledky testování.

Další informace o konfiguraci nastavení testu na použití prostředí při spuštění testů naleznete v Určení nastavení testů v nástroji Microsoft Test Manager nebo Vytváření nastavení testů pro automatizované systémové testy pomocí nástroje Microsoft Test Manager.

Viz také

Sdílet prostřednictvím

Jak: vytvoření Editor vlastních dat adaptéru diagnostických dat

Vytvoření vlastní Editor diagnostických dat adaptéru

Vytvořit vlastní editor adaptéru diagnostických dat

Viz také

Úkoly

Referenční dokumentace

Koncepty

Další materiály