DataCollection.NameProfile, méthode
La méthode NameProfile assigne une chaîne au processus ou au thread spécifié.
Espace de noms : Microsoft.VisualStudio.Profiler
Assembly : Microsoft.VisualStudio.Profiler (dans Microsoft.VisualStudio.Profiler.dll)
Syntaxe
'Déclaration
Public Shared Function NameProfile ( _
profileName As String, _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As NameOperationResult
public static NameOperationResult NameProfile(
string profileName,
ProfileLevel profileLevel,
uint elementId
)
public:
static NameOperationResult NameProfile(
String^ profileName,
ProfileLevel profileLevel,
unsigned int elementId
)
static member NameProfile :
profileName:string *
profileLevel:ProfileLevel *
elementId:uint32 -> NameOperationResult
public static function NameProfile(
profileName : String,
profileLevel : ProfileLevel,
elementId : uint
) : NameOperationResult
Paramètres
- profileName
Type : System.String
Nom de l'élément de profilage.
- profileLevel
Type : Microsoft.VisualStudio.Profiler.ProfileLevel
Identifie le niveau d'exécution de l'identificateur spécifié dans elementId.
- elementId
Type : System.UInt32
Identificateur du niveau de profilage.Utilisez l'identificateur de processus ou de thread généré par le système.
Valeur de retour
Type : Microsoft.VisualStudio.Profiler.NameOperationResult
La valeur de retour, NameOperationResult, est un enum.
Notes
Un seul nom peut être assigné à chaque processus ou thread. Une fois qu'un élément de profilage est nommé, les appels suivants à NameProfile pour cet élément sont ignorés.
Si le même nom est attribué à des threads ou processus différents, le rapport inclura les données de tous les éléments à ce niveau avec ce nom.
Si vous spécifiez un processus ou un thread différent de l'actuel, vous devez vérifier qu'il a été initialisé et qu'il a commencé à s'exécuter avant de le nommer. Sinon, la méthode NameProfile échoue. Les fonctions d'API CreateProcess() et CreateThread() peuvent être retournées avant que le thread ou le processus ne soit initialisé.
Exemples
L'exemple suivant illustre la méthode NameProfile.
public void ExerciseNameProfile()
{
// Create and initalize variables to pass to
// ExerciseNameProfile. The values of this
// parameter is based on the needs of the code;
// and for the sake of simplicity in this example,
// the variable is assigned
// an arbitrary value.
string profileName = "ExerciseNameProfile";
// Declare enumeration to hold result of call to
// ExerciseNameProfle.
NameOperationResult nameResult;
nameResult = DataCollection.NameProfile(
profileName,
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("NameProfile returned {0}", nameResult);
}
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.