Starten
Die Launch-Option startet den Profiler mithilfe der Samplingmethode. Darüber hinaus startet sie auch die angegebene Anwendung.
Um die Launch-Option verwenden zu können, müssen Sie die Sample-Methode in der Start-Option angeben.
VSPerfCmd.exe /Launch:AppName [Options]
Parameter
- AppName
Der Name der Anwendung, die gestartet werden soll. Vollständige Pfade und Teilpfade vom aktuellen Verzeichnis werden unterstützt.
Gültige Optionen
Die folgenden VSPerfCmd-Optionen können in Verbindung mit der Launch-Option in einer einzelnen Befehlszeile kombiniert werden.
**Start:**Method
Initialisiert die Befehlszeilen-Profilersitzung und legt die angegebene Profilerstellungsmethode fest.GlobalOnundGlobalOff
Damit wird die Profilerstellung fortgesetzt (GlobalOn) oder angehalten (GlobalOff), die Profilerstellungssitzung wird jedoch nicht beendet.**ProcessOn:**PID und ProcessOff:PID
Damit wird die Profilerstellung für den angegebenen Prozess fortgesetzt (ProcessOn) oder angehalten (ProcessOff).TargetCLR
Gibt die Version der .NET Framework-CLR (Common Language Runtime) an, für die ein Profil erstellt werden soll, wenn in einer Profilerstellungssitzung mehr als eine Version geladen wurde. Standardmäßig wird die zuerst geladene Version für die Profilerstellung verwendet.
Exklusive Optionen
Die folgenden Optionen können nur in Verbindung mit der Launch-Option verwendet werden.
Console
Startet die angegebene Befehlszeilenanwendung in einem neuen Fenster.**Args:**ArgList
Gibt die Liste der an die Anwendung zu übergebenden Argumente an.LineOff
Deaktiviert der Auflistung von Profilerstellungsdaten auf Zeilenebene.
Samplingoptionen
In der Launch-Befehlszeile kann eine der folgenden Samplingintervalloptionen angegeben werden. Das Standardsamplingintervall beträgt 10.000.000 Prozessortaktzyklen.
Timer[**:Cycles]PF[:Events]Sys[:Events]Counter[:**Name,Reload,FriendlyName]GC[:allocation|lifetime]
Gibt die Anzahl und den Typ des Samplingintervalls an.Timer - Führt alle Cycles nicht angehaltene Prozessortaktzyklen ein Sampling durch. Wenn Cycles nicht angegeben ist, werden 10.000.000 Zyklen verwendet.
PF - Führt alle Events Seitenfehler ein Sampling durch. Wenn Events nicht angegeben ist, werden 10 Seitenfehler verwendet.
Sys - Führt alle Events Aufrufe des Betriebssystems ein Sampling durch. Wenn Events nicht angegeben ist, werden 10 Systemaufrufe verwendet.
Counter - Führt alle Reload CPU-Leistungsindikatoren, die mit Name angegeben sind, ein Sampling durch. Optional kann FriendlyName eine Zeichenfolge angeben, die in Profilerberichten als Spaltenüberschrift verwendet werden soll.
GC - Sammelt .NET-Arbeitsspeicherdaten. Standardmäßig (allocation) werden Daten bei jeder Speicherbelegung gesammelt. Wenn der lifetime-Parameter angegeben wird, werden Daten auch bei jedem Garbage Collection-Ereignis erfasst.
Beispiel
In diesem Beispiel wird die Verwendung der Launch-Option zum Starten einer Anwendung veranschaulicht.
VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Launch:TestApp.exe
Siehe auch
Referenz
Konzepte
Profilerstellung für eigenständige Anwendungen über die Befehlszeile
Profilerstellung für ASP.NET-Webanwendungen über die Befehlszeile