Método DataCollection.NameProfile

Artigo
08/01/2011

O método NameProfile atribui uma seqüência de caracteres especificado do processo ou segmento.

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

Sintaxe

'Declaração
Public Shared Function NameProfile ( _
    profileName As String, _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As NameOperationResult

public static NameOperationResult NameProfile(
    string profileName,
    ProfileLevel profileLevel,
    uint elementId
)

public:
static NameOperationResult NameProfile(
    String^ profileName, 
    ProfileLevel profileLevel, 
    unsigned int elementId
)

static member NameProfile : 
        profileName:string * 
        profileLevel:ProfileLevel * 
        elementId:uint32 -> NameOperationResult

public static function NameProfile(
    profileName : String, 
    profileLevel : ProfileLevel, 
    elementId : uint
) : NameOperationResult

Parâmetros

profileName
Tipo: System.String
O nome do elemento de criação de perfil.

profileLevel
Tipo: Microsoft.VisualStudio.Profiler.ProfileLevel
Identifica o nível de execução do identificador especificado em elementId.

elementId
Tipo: System.UInt32
Identificador de nível de criação de perfil.Use o processo ou thread identificador gerado pelo sistema.

Valor de retorno

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

Comentários

Apenas um nome pode ser atribuído a cada processo ou segmento. Depois de um elemento de criação de perfil é nomeado, as chamadas subseqüentes para NameProfile desse elemento são ignoradas.

Se o mesmo nome for fornecido para diferentes segmentos ou processos, o relatório incluirá dados de todos os elementos nesse nível com esse nome.

Se você especificar um processo ou segmento diferente da atual, você deve garantir que ele foi inicializado e iniciado em execução antes de nomeá-la. Caso contrário, o método NameProfile falhará. Funções de CreateProcess () e a API de CreateThread() podem retornar antes do thread ou processo é inicializado.

Exemplos

O exemplo a seguir ilustra o método NameProfile.

        public void ExerciseNameProfile()
        {
            // Create and initalize variables to pass to 
            // ExerciseNameProfile.  The values of this 
            // parameter is based on the needs of the code;
            // and for the sake of simplicity in this example, 
            // the variable is assigned 
            // an arbitrary value.
            string profileName = "ExerciseNameProfile";

            // Declare enumeration to hold result of call to 
            // ExerciseNameProfle.
            NameOperationResult nameResult;

            nameResult =  DataCollection.NameProfile(
                profileName,
                ProfileLevel.Global,
                DataCollection.CurrentId);

            Console.WriteLine("NameProfile returned {0}", nameResult);
        }

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

Partilhar via