DataCollection.StartProfile-Methode
Die StartProfile-Methode legt den Indikator für die angegebene Profilebene auf 1 (ON) fest.
Namespace: Microsoft.VisualStudio.Profiler
Assembly: Microsoft.VisualStudio.Profiler (in Microsoft.VisualStudio.Profiler.dll)
Syntax
'Declaration
Public Shared Function StartProfile ( _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult StartProfile(
ProfileLevel profileLevel,
uint elementId
)
public:
static ProfileOperationResult StartProfile(
ProfileLevel profileLevel,
unsigned int elementId
)
static member StartProfile :
profileLevel:ProfileLevel *
elementId:uint32 -> ProfileOperationResult
public static function StartProfile(
profileLevel : ProfileLevel,
elementId : uint
) : ProfileOperationResult
Parameter
- profileLevel
Typ: Microsoft.VisualStudio.Profiler.ProfileLevel
Identifiziert die Ausführungsebene des in elementId angegebenen Bezeichners.
- elementId
Typ: System.UInt32
Der vom System generierte Prozess- oder Threadbezeichner.
Rückgabewert
Typ: Microsoft.VisualStudio.Profiler.ProfileOperationResult
Der Rückgabewert ProfileOperationResult ist eine Enumeration.
Hinweise
Durch StartProfile und StopProfile wird der Start/Stop-Zustand für die Profilebene gesteuert. Der Standardanfangswert von Starten/Beenden ist 1. Der Anfangswert kann in der Registrierung geändert werden. Durch jeden Aufruf von StartProfile wird Start/Stop auf 1 festgelegt, während durch jeden Aufruf von StopProfile Start/Stop auf 0 (null) festgelegt wird.
Wenn Start/Stop größer als 0 (null) ist, lautet der Start/Stop-Zustand für die Ebene ON. Ist der Wert kleiner oder gleich 0 (null), lautet der Start/Stop-Zustand OFF.
Wenn sowohl der Start/Stop-Zustand als auch der Suspend/Resume-Zustand ON lautet, ist auch der Profilerstellungszustand für die Ebene auf ON festgelegt. Wenn ein Profil für einen Thread erstellt werden soll, muss der Zustand des Threads sowohl auf der globalen Ebene als auch auf der Prozessebene und der Threadebene ON lauten.
Beispiele
Das folgende Beispiel veranschaulicht die StartProfile-Methode.
public void ExerciseStartProfile()
{
// StartProfile and StopProfile control the
// Start/Stop state for the profiling level.
// The default initial value of Start/Stop is 1.
// The initial value can be changed in the registry.
// Each call to StartProfile sets Start/Stop to 1;
// each call to StopProfile sets it to 0.
// Declare enumeration to hold return value of
// the call to StartProfile.
ProfileOperationResult profileResult;
profileResult = DataCollection.StartProfile(
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("StartProfile returned {0}", profileResult);
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.