DataCollection.MarkProfile, méthode
La méthode MarkProfile insère une marque de profil dans le fichier .vsp. Le profilage du thread contenant la fonction MarkProfile doit être ON pour que la marque soit insérée.
Espace de noms : Microsoft.VisualStudio.Profiler
Assembly : Microsoft.VisualStudio.Profiler (dans Microsoft.VisualStudio.Profiler.dll)
Syntaxe
'Déclaration
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
Paramètres
- markId
Type : System.Int32
Marqueur à insérer.Le marqueur doit être supérieur ou égal à 0 (zéro).
Valeur de retour
Type : Microsoft.VisualStudio.Profiler.MarkOperationResult
La valeur de retour, MarkOperationResult, est un enum.
Notes
La valeur de la marque est insérée dans le fichier .vsp chaque fois que le code s'exécute si le thread contenant la fonction MarkProfile est profilé. Vous pouvez appeler MarkProfile plusieurs fois.
Les marques de profil sont globales dans la portée. Par exemple, une marque de profil insérée dans un seul thread peut être utilisée pour marquer le début ou la fin d'un segment de données de n'importe quel thread dans le fichier .vsp.
L'état de profilage du thread qui contient la fonction de profil de la marque doit être activé lorsque les marques et les commentaires sont insérés à l'aide de la commande Mark ou des fonctions API (CommentMarkAtProfile, CommentMarkProfile ou MarkProfile).
Important
Les méthodes MarkProfile doivent être utilisées uniquement avec l'instrumentation.
Exemples
L'exemple suivant illustre la méthode MarkProfile.
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);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.