DataCollection.SuspendProfile (Método)

El método SuspendProfile incrementa el contador Suspend/Resume para el nivel de generación de perfiles especificado.

Espacio de nombres:  Microsoft.VisualStudio.Profiler
Ensamblado:  Microsoft.VisualStudio.Profiler (en Microsoft.VisualStudio.Profiler.dll)

Sintaxis

'Declaración
Public Shared Function SuspendProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult

public static ProfileOperationResult SuspendProfile(
    ProfileLevel profileLevel,
    uint elementId
)

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

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

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

Parámetros

• profileLevel
  Tipo: Microsoft.VisualStudio.Profiler.ProfileLevel
  Identifica el nivel de ejecución del identificador especificado en elementId.

• elementId
  Tipo: System.UInt32
  Identificador del proceso o del subproceso generado por el sistema.

Valor devuelto

Tipo: Microsoft.VisualStudio.Profiler.ProfileOperationResult
El valor devuelto, ProfileOperationResult, es una enumeración.

Comentarios

SuspendProfile y ResumeProfile controlan el contador Suspend/Resume del nivel de generación de perfiles.El contador Suspend/Resume se utiliza normalmente para reemplazar las funciones de control de datos de la API del generador de perfiles estándar.

El valor inicial del contador Suspend/Resume es 0.Cada llamada a SuspendProfile suma 1 a este contador, cada llamada a ResumeProfile le resta 1.

Cuando el valor del contador Suspend/Resume es mayor que 0, el estado de Suspend/Resume del nivel es OFF.Cuando el recuento es menor o igual que 0, el estado de Suspend/Resume es ON.

Cuando los estados de Start/Stop y de Suspend/Resume son ON, el estado de generación de perfiles del nivel es ON.Para que se generen los perfiles de un subproceso los estados del subproceso en los niveles global, de proceso y de subproceso deben ser ON.

Ejemplos

En el siguiente ejemplo se ilustra el método SuspendProfile.En este ejemplo se asume que previamente se ha realizado una llamada a StartProfile para el proceso o subproceso identificado por la propiedad DataCollection.CurrentId.

        public void ExerciseSuspendProfile()
        {
            // The initial value of the Suspend/Resume counter is 0.
            // Each call to SuspendProfile adds 1 to the 
            // Suspend/Resume count; each call 
            // to ResumeProfile subtracts 1. 
                        
            // Declare enumeration to hold result of call 
            // to SuspendProfile
            ProfileOperationResult profileResult;

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

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

DataCollection Clase

Microsoft.VisualStudio.Profiler (Espacio de nombres)