ILoadTestPlugin-Schnittstelle

Definiert eine Schnittstelle, die so implementiert ist, dass die beim Ausführen des Auslastungstests und der darin enthaltenen Tests auftretenden Ereignisse von einer vom Benutzer erstellten Klasse behandelt werden können.

Namespace:  Microsoft.VisualStudio.TestTools.LoadTesting
Assembly:  Microsoft.VisualStudio.QualityTools.LoadTestFramework (in Microsoft.VisualStudio.QualityTools.LoadTestFramework.dll)

Syntax

'Declaration
Public Interface ILoadTestPlugin

public interface ILoadTestPlugin

public interface class ILoadTestPlugin

type ILoadTestPlugin =  interface end

public interface ILoadTestPlugin

Der ILoadTestPlugin-Typ macht die folgenden Member verfügbar.

Methoden

	Name	Beschreibung
	Initialize	Initialisiert das Auslastungstest-Plug-In.

Zum Seitenanfang

Hinweise

Dies kann mit einer durch den Benutzer erstellten Klasse implementiert werden, um den vom Benutzer erstellten Code in das Auslastungstest-Laufzeitmodul auf dem Agent einzubinden. Das entsprechende Plug-In wird im Auslastungstest-Editor angegeben.

Sie können ein Auslastungstest-Plug-In erstellen, um bei der Ausführung eines Auslastungstests Code zu verschiedenen Zeiten auszuführen, z. B. nach Überschreitung eines Schwellenwerts, vor dem Start und nach Abschluss eines Auslastungstests, vor dem Start und nach Abschluss einer Testiteration, bei Abbruch eines Auslastungstests oder wenn sich die Auslastung im Test geändert hat. Folgende Ereignisse können durch die Implementierung von ILoadTestPlugin behandelt werden: LoadTestStarting, LoadTestFinished, LoadTestWarmupComplete, TestStarting, TestFinished, TestSelected, ThresholdExceeded, HeartBeat() und LoadTestAborted.

Die Implementierung eines Auslastungstest-Plug-Ins kann zum Erweitern oder Ändern des Verhaltens eines Auslastungstests bei der Ausführung verwendet werden. Die folgende Liste enthält einige Verwendungsmöglichkeiten für ein Auslastungstest-Plug-In:

• Starten eines externen Prozesses, z. B. eines Überwachungstools, kurz vor dem Starten des Auslastungstests und Beenden des Prozesses bei Abschluss des Auslastungstests.

• Programmgesteuerte Benutzerauslastung während der Ausführung des Auslastungstests, Überschreiben der im Auslastungstest-Editor angegebenen Benutzerauslastung.

• Programmgesteuerte Auswahl eines einzelnen innerhalb des Auslastungstests auszuführenden Tests, Überschreiben des Standard-Testauswahlalgorithmus.

• Abbrechen des Auslastungstests, wenn der Wert eines Leistungsindikators das Fehlschlagen einer im Auslastungstest definierten Schwellenwertregel verursacht.

• Beibehalten einer gemeinsamen Variable für alle Testiterationen eines Auslastungstests. Dazu implementiert das Auslastungstest-Plug-In eine Variable als statische Eigenschaft, auf die die Tests unter Belastung zugreifen. Die Variable wird in der Initialize-Methode des Auslastungstest-Plug-Ins initialisiert. Ein Ereignishandler wird für das LoadTestFinished-Ereignis hinzugefügt, mit dem zu Berichtszwecken auf den endgültigen Wert zugegriffen werden kann.

Hinweise zur Implementierung

Wird der Auslastungstest auf mehreren Agents ausgeführt, wird die Auslastungstest-Plug-In-Klasse auf allen Agents instanziiert. Wenn das Auslastungstest-Plug-In einen Vorgang nur auf einem Agent ausführen muss, sollte die AgentId-Eigenschaft des LoadTestContext-Objekts überprüft und der Vorgang nur ausgeführt werden, wenn der Wert von AgentId 1 ist.

Beispiele

Ein Beispiel finden Sie unter Gewusst wie: Erstellen eines Auslastungstest-Plug-Ins.

Siehe auch

Referenz

Microsoft.VisualStudio.TestTools.LoadTesting-Namespace