Metodo DataCollection.StartProfile

Articolo
08/11/2011

Il metodo StartProfile imposta il contatore su 1 (on) per il livello di analisi specificato.

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

Sintassi

'Dichiarazione
Public Shared Function StartProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult

public static ProfileOperationResult StartProfile(
    ProfileLevel profileLevel,
    uint elementId
)

public:
static ProfileOperationResult StartProfile(
    ProfileLevel profileLevel, 
    unsigned int elementId
)

static member StartProfile : 
        profileLevel:ProfileLevel * 
        elementId:uint32 -> ProfileOperationResult

public static function StartProfile(
    profileLevel : ProfileLevel, 
    elementId : uint
) : ProfileOperationResult

Parametri

profileLevel
Tipo: Microsoft.VisualStudio.Profiler.ProfileLevel
Identifica il livello di esecuzione dell'identificatore specificato in elementId.

elementId
Tipo: System.UInt32
Identificatore del processo o del thread generato dal sistema.

Valore restituito

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

Note

StartProfile e StopProfile controllano lo stato Start/Stop per il livello di profilo. Il valore iniziale di Start/Stop è 1. Il valore iniziale può essere modificato nel Registro di sistema. Ogni chiamata a StartProfile e a StopProfile imposta Start/Stop rispettivamente su 1 e su 0.

Quando il valore di Start/Stop è maggiore di 0, lo stato Start/Stop del livello è ON. Quando il valore del contatore è minore o uguale a 0, lo stato Start/Stop è OFF.

Quando gli stati Start/Stop e Suspend/Resume sono entrambi impostati su ON, lo stato di profilo del livello è ON. Per il profilo di un thread, è necessario che gli stati a livello globale, di processo e di thread siano tutti impostati su ON.

Esempi

Nell'esempio riportato di seguito viene illustrato il metodo StartProfile.

        public void ExerciseStartProfile()
        {
            // StartProfile and StopProfile control the
            // Start/Stop state for the profiling level. 
            // The default initial value of Start/Stop is 1. 
            // The initial value can be changed in the registry. 
            // Each call to StartProfile sets Start/Stop to 1; 
            // each call to StopProfile sets it to 0. 
            
            // Declare enumeration to hold return value of 
            // the call to StartProfile.
            ProfileOperationResult profileResult;

            profileResult = DataCollection.StartProfile(
                ProfileLevel.Global,
                DataCollection.CurrentId);

            Console.WriteLine("StartProfile returned {0}", profileResult);
        }

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

DataCollection Classe

Spazio dei nomi Microsoft.VisualStudio.Profiler

Condividi tramite