Jak: tworzenie edytora niestandardowe dla danych dla karty danych diagnostycznych

Artykuł
02/27/2013

Podczas tworzenia karty danych diagnostycznych chcesz umożliwić użytkownikowi na skonfigurowanie określonych danych po wybraniu karty niestandardowe dane diagnostyczne dla ustawienia ich badania.Na przykład można wybierać dane konfiguracji, które określa, które klucze rejestru, aby wyodrębnić, jaki poziom obciążenia sieci, aby symulować lub w których katalogu, aby znaleźć pliki tymczasowe lub plików, aby dołączyć pracy.

Do ustawiania wartości początkowej, karty danych diagnostycznych, należy użyć pliku konfiguracji.Można zapewnić niestandardowe edytor, aby umożliwić użytkownikowi modyfikowanie danych konfiguracji.

Aby utworzyć własne edytora, utworzy formant użytkownika, który implementuje IDataCollectorConfigurationEditor.

Karta dane diagnostyczne można użyć DataCollectorConfigurationEditorAttribute do określenia klasy edytor do edycji ustawień konfiguracji danych diagnostycznych.

Należy także określić dane konfiguracji domyślnej, które chcesz użyć.Zobacz Przykładowy projekt do tworzenia diagnostyczne karta danych dla próbki domyślnej konfiguracji.

Poniższa procedura umożliwia utworzenie niestandardowego Edytor aktualizacji danych w ustawieniach badania, gdy jest używana karta diagnostyczne niestandardowe dane.

[!UWAGA]

Aby utworzyć niestandardowe edytora, należy najpierw utworzyć karty danych diagnostycznych, który ma DataCollectorConfigurationEditorAttribute stosowane do tej klasy.Opcjonalnie można użyć HelpUri właściwości tego atrybutu, aby określić źródło zawartości pomocy dla edytora.Aby uzyskać więcej informacji na temat tworzenia karta dane diagnostyczne Zobacz Jak: tworzenie diagnostyczne karta danych.

Projektu karty danych diagnostycznych kompletnym przykładzie, włączając edytora konfiguracji niestandardowych, zobacz Przykładowy projekt do tworzenia diagnostyczne karta danych.

Tworzenie edytora niestandardowe karty danych diagnostycznych

Aby utworzyć niestandardowe edytora karty dane diagnostyczne

Tworzenie formantu użytkownika w programie project dla karty diagnostyczne danych:
1. Kliknij prawym przyciskiem myszy projekt kodu, który zawiera klasy karty danych diagnostycznych, wskaż polecenie Dodaj , a następnie kliknij polecenie Kontrola użytkownika.
2. W tym przykładzie należy dodać etykietę do formularza z następującym tekstem: Nazwa pliku danych: i pole tekstowe o nazwie FileTextBox, która umożliwi użytkownikowi wprowadzanie niezbędnych danych.
[!UWAGA]

Obecnie obsługiwane są tylko formanty użytkownika Windows Forms.

Dodać następujące wiersze do sekcji deklaracji:

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

Ten formant użytkownika można przekształcić w niestandardowych edytora.
1. Kliknij prawym przyciskiem myszy formant użytkownika w projekcie kodu i wskaż Widok Kod.
2. Ustawianie klasy implementującej interfejs edytora IDataCollectorConfigurationEditor w następujący sposób:
```
   public partial class MyDataConfigEditor :
        UserControl, IDataCollectorConfigurationEditor
```
1. Kliknij prawym przyciskiem myszy IDataCollectorConfigurationEditor w kodzie, a następnie wybierz Implementacja interfejsu polecenia.Metody, które musi implementować dla tego interfejsu są dodawane do klasy.
2. Dodaj DataCollectorConfigurationEditorAttribute do kontrolki użytkownika dla edytora zidentyfikować go jako edytora karty danych diagnostycznych, zastępując firmy, produktu, i wersji odpowiednie informacje dla karty danych diagnostycznych:
```
[DataCollectorConfigurationEditorTypeUri(
    "configurationeditor://MyCompany/MyConfigEditor/1.0")]
```

Dodać dwie zmienne prywatne w następujący sposób:

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

Dodawanie kodu do zainicjowania edytora karty danych diagnostycznych.Za pomocą danych w zmiennej ustawienia domyślne wartości można dodać do pola w kontrolki użytkownika.Są to dane, który znajduje się w <DefaultConfiguration> elementu w pliku konfiguracyjnym XML dla karty.

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

Dodaj kod, aby zapisać dane z formantów w edytorze z powrotem do formatu XML, wymagane przez dane diagnostyczne karty interfejsu API w następujący sposób:

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

Jeśli jest ważne, aby można dodać kod do sprawdzenia, dane są prawidłowe w VerifyData metody lub użytkownik może mieć metoda zwraca true.
```
public bool VerifyData()
{
    // Not currently verifying data
    return true;
}
```

(Opcjonalnie) Można dodać kod, aby przywrócić dane początkowe ustawienia, które są dostarczane w pliku konfiguracyjnym XML w ResetToAgentDefaults() metodę, która używa prywatnego getText() metody.

// 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;
}

Skompiluj rozwiązanie.Kopiowanie zestawu danych diagnostycznych karty i plik konfiguracyjny XML (<diagnostic data adapter name>.dll.config) w następującej lokalizacji na podstawie katalogu instalacji: Program Files\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\DataCollectors.

[!UWAGA]

Chociaż Edytor konfiguracji może być w projekcie i to zespół, który różni się od karty danych diagnostycznych, również mogą być w tym samym zestawie.
Aby użyć karty danych diagnostycznych w badaniach, musi wybierz z listy istniejących ustawień testu lub utworzyć nowy od Microsoft Test Manager lub Visual Studio i następnie wybierz opcję Karta danych diagnostycznych.

Karta jest wyświetlana na danych i diagnostyki na karcie Ustawienia badania z przyjaznej nazwy, który został przypisany do tej klasy.
Aby skonfigurować kartę danych diagnostycznych dla ustawień testu, wybierz polecenie Konfigurowanie obok nazwy karty.

Edytor niestandardowe jest teraz wyświetlany.
Edytowanie pól w edytorze niestandardowe jako wymagane, a następnie wybierz polecenie zapisać.
Jeśli są uruchomione testy z Microsoft Test Manager, można przypisać te testowania ustawień do planu badań, przed uruchomieniem testy, lub użyć uruchomić z opcjami polecenia Testuj ustawienia przypisywania i zastępowania testowania ustawień.Aby uzyskać więcej informacji na temat Testuj ustawienia, zobacz Konfigurowanie maszyn i zbierania informacji diagnostycznych przy użyciu ustawień testu.
Przed użyciem Edytora konfiguracji nowej karty danych diagnostycznych, należy zastosować DataCollectorConfigurationEditorAttribute do każdej klasy karty danych diagnostycznych, który chcesz używać edytora, należy ponownie skompilować i ponownie je zainstalować na komputerze klienckim.Aby uzyskać więcej informacji dotyczących sposobu instalowania karty danych diagnostycznych i edytory konfiguracji, zobacz Jak: Instalowanie karty danych diagnostycznych niestandardowe.
Uruchom testy Testuj ustawienia przy użyciu karty danych diagnostycznych zaznaczone.

Plik danych, określoną w oknie edytora załączony jest do wyniki testu.

Aby uzyskać więcej informacji dotyczących sposobu konfigurowania ustawienia test, aby użyć środowiska, po uruchomieniu testów, zobacz Wprowadzanie ustawień testów w programie Microsoft Test Manager lub Tworzenie ustawień automatycznych testów systemowych przy użyciu programu Microsoft Test Manager.

Zobacz też

Udostępnij za pośrednictwem

Jak: tworzenie edytora niestandardowe dla danych dla karty danych diagnostycznych

Tworzenie edytora niestandardowe karty danych diagnostycznych

Aby utworzyć niestandardowe edytora karty dane diagnostyczne

Zobacz też

Zadania

Informacje

Koncepcje

Dodatkowe zasoby