DataCollection.MarkProfile (Método)

El método MarkProfile inserta una marca de perfil en el archivo .vsp.La generación de perfiles para el subproceso que contiene la función MarkProfile debe estar activada (ON) para que se inserte la marca.

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

Sintaxis

'Declaración
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

Parámetros

• markId
  Tipo: System.Int32
  Marcador que se inserta.El marcador debe ser mayor o igual que 0 (cero).

Valor devuelto

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

Comentarios

El valor de marca se inserta en el archivo .vsp cada vez que el código se ejecuta si se generan los perfiles del subproceso que contiene la función MarkProfile.Puede llamar varias veces a MarkProfile.

Las marcas de perfil tienen un ámbito global.Por ejemplo, una marca de perfil insertada en un subproceso se puede utilizar para marcar el inicio y el final de un segmento de datos en cualquier subproceso del archivo .vsp.

El estado de generación de perfiles del subproceso que contiene la función de perfil de marcas debe estar activado cuando se inserten marcas o comentarios con el comando Mark o con las funciones de la API (CommentMarkAtProfile, CommentMarkProfile o MarkProfile).

Importante
Los métodos MarkProfile sólo se deben utilizar con la instrumentación.

Ejemplos

En el siguiente ejemplo se ilustra el método 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);
        }

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)