Metodo DataCollection.NameProfile

Il metodo NameProfile assegna una stringa al processo o al thread specificato.

Spazio dei nomi:  Microsoft.VisualStudio.Profiler
Assembly:  Microsoft.VisualStudio.Profiler (in Microsoft.VisualStudio.Profiler.dll)

Sintassi

'Dichiarazione
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

Parametri

  • elementId
    Tipo: System.UInt32
    Identificatore del livello di profilo.Utilizzare l'identificatore del processo o del thread generato dal sistema.

Valore restituito

Tipo: Microsoft.VisualStudio.Profiler.NameOperationResult
Il valore restituito, NameOperationResult, è un'enumerazione.

Note

A ogni processo o thread è possibile assegnare un solo nome. Dopo aver assegnato un nome a un elemento di profilo, le chiamate successive alla funzione NameProfile relative all'elemento in questione verranno ignorate.

Se viene assegnato lo stesso nome a thread o processi diversi, nel report saranno inclusi i dati di tutti gli elementi con quel nome presenti nel livello specifico.

Se si specifica un processo o un thread diverso da quello attuale, è necessario verificare che sia stato inizializzato e avviato prima dell'assegnazione del nome. In caso contrario, l'esecuzione del metodo NameProfile avrà esito negativo. Le funzioni API CreateProcess() e CreateThread() possono essere entrambe restituite prima dell'inizializzazione del thread o del processo.

Esempi

Nell'esempio riportato di seguito viene illustrato il metodo 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);
        }

Sicurezza di .NET Framework

Vedere anche

Riferimenti

DataCollection Classe

Spazio dei nomi Microsoft.VisualStudio.Profiler

  • Last updated on