Método DataCollection.CommentMarkAtProfile

Artigo
08/01/2011

O método de CommentMarkAtProfile insere um valor de carimbo de hora, uma marca numérica e uma seqüência de caracteres de comentário no arquivo. vsp. O valor de carimbo de hora pode ser usado para sincronizar os eventos externos. Criação de perfil para o segmento que contém a função de CommentMarkAtProfile deve estar Diante para a marca e a comentar a ser inserido.

Namespace: Microsoft.VisualStudio.Profiler
Assembly: Microsoft.VisualStudio.Profiler (em Microsoft.VisualStudio.Profiler.dll)

Sintaxe

'Declaração
Public Shared Function CommentMarkAtProfile ( _
    timestamp As Long, _
    markId As Integer, _
    markText As String _
) As MarkOperationResult

public static MarkOperationResult CommentMarkAtProfile(
    long timestamp,
    int markId,
    string markText
)

public:
static MarkOperationResult CommentMarkAtProfile(
    long long timestamp, 
    int markId, 
    String^ markText
)

static member CommentMarkAtProfile : 
        timestamp:int64 * 
        markId:int * 
        markText:string -> MarkOperationResult

public static function CommentMarkAtProfile(
    timestamp : long, 
    markId : int, 
    markText : String
) : MarkOperationResult

Parâmetros

timestamp
Tipo: System.Int64
Um inteiro de 64 bits que representa um valor de carimbo de hora.

markId
Tipo: System.Int32
O marcador numérico para inserir.O marcador deve ser maior ou igual a 0 (zero).

markText
Tipo: System.String
Um ponteiro para a seqüência de texto para inserir.A seqüência de caracteres deve ser menor que 256 caracteres, incluindo o terminador nulo.

Valor de retorno

Tipo: Microsoft.VisualStudio.Profiler.MarkOperationResult
O valor de retorno, MarkOperationResult, é um enum.

Comentários

O estado de perfil para o segmento que contém a função de perfil da marca deve estar na quando as marcas e comentários são inseridos com o comando marcar ou com funções de API (CommentMarkAtProfile, CommentMarkProfile ou MarkProfile). Marcas de perfil são globais em escopo. Por exemplo, uma marca de perfil inserida em um thread pode ser usada para marcar o início ou fim de um segmento de dados em qualquer segmento no arquivo. vsp.

Importante
Métodos de CommentMarkAtProfile devem ser usados com a instrumentação somente.

Exemplos

O exemplo a seguir ilustra uma chamada ao método CommentMarkAtProfile.

        public void ExerciseCommentMarkAtProfile()
        {
            // Declare and initalize variables to pass to 
            // CommentMarkAtProfile.  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.
            long timestamp = 0x1111;
            int markId = 01;
            string markText = "Exercising CommentMarkAtProfile...";

            // Declare MarkOperationResult Enumerator.  
            // Holds return value from call to CommentMarkAtProfile.
            MarkOperationResult markResult;

            markResult = DataCollection.CommentMarkAtProfile(
                timestamp,
                markId,
                markText);

            // Check result of CommentMarkAtProfile call.
            Console.WriteLine("CommentMarkAtProfile returned {0}",
                markResult); 
        }

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

DataCollection Classe

Namespace Microsoft.VisualStudio.Profiler

Compartilhar via