DataCollection.MarkProfile-Methode
Mit der MarkProfile-Methode wird eine Profilmarkierung in die VSP-Datei eingefügt. Damit die Markierung eingefügt wird, muss die Profilerstellung für den Thread, der die MarkProfile-Funktion enthält, auf ON festgelegt sein.
Namespace: Microsoft.VisualStudio.Profiler
Assembly: Microsoft.VisualStudio.Profiler (in Microsoft.VisualStudio.Profiler.dll)
Syntax
'Declaration
Public Shared Function MarkProfile ( _
markId As Integer _
) As MarkOperationResult
public static MarkOperationResult MarkProfile(
int markId
)
public:
static MarkOperationResult MarkProfile(
int markId
)
static member MarkProfile :
markId:int -> MarkOperationResult
public static function MarkProfile(
markId : int
) : MarkOperationResult
Parameter
- markId
Typ: System.Int32
Die einzufügende Markierung.Diese muss größer oder gleich 0 (null) sein.
Rückgabewert
Typ: Microsoft.VisualStudio.Profiler.MarkOperationResult
Der Rückgabewert MarkOperationResult ist eine Enumeration.
Hinweise
Der bei jeder Ausführung des Codes in die VSP-Datei eingefügte Markierungswert, wenn für den Thread, der die MarkProfile-Funktion enthält, ein Profil erstellt wird. Sie können MarkProfile mehrmals aufrufen.
Profilmarkierungen weisen einen globalen Gültigkeitsbereich auf. So kann beispielsweise eine Profilmarkierung, die in einem Thread eingefügt wurde, verwendet werden, um den Anfang oder das Ende eines Datensegments in einem beliebigen Thread in der VSP-Datei zu markieren.
Der Profilerstellungszustand des Threads, der die Funktion zum Markieren von Profilen enthält, muss ON lauten, wenn Markierungen und Kommentare mit dem Mark-Befehl oder mit API-Funktionen (CommentMarkAtProfile, CommentMarkProfile oder MarkProfile) eingefügt werden.
Wichtig
MarkProfile-Methoden sollten nur mit der Instrumentation verwendet werden.
Beispiele
Das folgende Beispiel veranschaulicht die MarkProfile-Methode.
public void ExerciseMarkProfile()
{
// Declare and initialize variables to pass to
// MarkProfile. The values of these parameters
// are assigned based on the needs of the code;
// and for the sake of simplicity in this example,
// the variables are assigned arbitrary values.
int markId = 03;
// Declare enumeration to hold return value of
// call to MarkProfile.
MarkOperationResult markResult;
markResult = DataCollection.MarkProfile(
markId);
Console.WriteLine("MarkProfile returned {0}", markResult);
}
.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.