DataCollection.SuspendProfile-Methode
Die SuspendProfile-Methode inkrementiert den Suspend/Resume-Zähler für die angegebene Profilebene.
Namespace: Microsoft.VisualStudio.Profiler
Assembly: Microsoft.VisualStudio.Profiler (in Microsoft.VisualStudio.Profiler.dll)
Syntax
'Declaration
Public Shared Function SuspendProfile ( _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult SuspendProfile(
ProfileLevel profileLevel,
uint elementId
)
public:
static ProfileOperationResult SuspendProfile(
ProfileLevel profileLevel,
unsigned int elementId
)
static member SuspendProfile :
profileLevel:ProfileLevel *
elementId:uint32 -> ProfileOperationResult
public static function SuspendProfile(
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 SuspendProfile und ResumeProfile wird der Suspend/Resume-Zähler für die Profilebene gesteuert. Der Suspend/Resume-Zähler wird i. d. R. verwendet, um die standardmäßigen Datensteuerungsfunktionen der Profiler-API zu überschreiben.
Der Anfangswert des Suspend/Resume-Indikators ist 0. Jeder Aufruf von SuspendProfile fügt der Suspend/Resume-Anzahl 1 hinzu; jeder Aufruf von ResumeProfile subtrahiert 1.
Wenn die Suspend/Resume-Anzahl größer als 0 (null) ist, lautet der Suspend/Resume-Zustand für die Ebene OFF. Ist die Anzahl kleiner oder gleich 0 (null), lautet der Suspend/Resume-Zustand ON.
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 SuspendProfile-Methode. In diesem Beispiel wird davon ausgegangen, dass ein vorheriger Aufruf von StartProfile für den durch die DataCollection.CurrentId-Eigenschaft identifizierten Prozess oder Thread erfolgt ist.
public void ExerciseSuspendProfile()
{
// The initial value of the Suspend/Resume counter is 0.
// Each call to SuspendProfile adds 1 to the
// Suspend/Resume count; each call
// to ResumeProfile subtracts 1.
// Declare enumeration to hold result of call
// to SuspendProfile
ProfileOperationResult profileResult;
profileResult = DataCollection.SuspendProfile(
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("SuspendProfile 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.