Método DataCollection.CommentMarkProfile

Artigo
08/01/2011

O método de CommentMarkProfile insere um marcador numérico e uma seqüência de caracteres de texto no arquivo. vsp. Criação de perfil para o segmento que contém a função de CommentMarkProfile 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 CommentMarkProfile ( _
    markId As Integer, _
    markText As String _
) As MarkOperationResult

public static MarkOperationResult CommentMarkProfile(
    int markId,
    string markText
)

public:
static MarkOperationResult CommentMarkProfile(
    int markId, 
    String^ markText
)

static member CommentMarkProfile : 
        markId:int * 
        markText:string -> MarkOperationResult

public static function CommentMarkProfile(
    markId : int, 
    markText : String
) : MarkOperationResult

Parâmetros

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 em quando marcas e comentários inseridos com o comando VSInstr marca ou com funções de membro do Microsoft.VisualStudio.Profiler.DataCollection (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 CommentMarkProfile devem ser usados com a instrumentação somente.

Exemplos

O exemplo a seguir ilustra o método MarkOperationResult.

        public void ExerciseMarkOperationResult()
        {
            // 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 = 4;

            // Declare enumeration to hold return value of 
            // call to MarkProfile.
            MarkOperationResult result;

            result = DataCollection.MarkProfile(markID);

            // Compare result to MarkOperationResult value.  
            // In this case, the property value of 
            // MarkOperationResult is "OK".
            if (result == MarkOperationResult.OK)
            {
                Console.WriteLine("PASS -- Test {0}", result);
            }
            else
            {
                Console.WriteLine("FAIL -- MarkProfile Returned code {0} with normal input", result.ToString());
            }
        }

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