DataCollection.NameProfile-Methode

Artikel
07/20/2011

Mit der NameProfile-Methode wird dem angegebenen Prozess oder Thread eine Zeichenfolge zugewiesen.

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

Syntax

'Declaration
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

Parameter

profileName
Typ: System.String
Der Name des Profilelements.

profileLevel
Typ: Microsoft.VisualStudio.Profiler.ProfileLevel
Identifiziert die Ausführungsebene des in elementId angegebenen Bezeichners.

elementId
Typ: System.UInt32
Bezeichner der Profilebene.Verwenden Sie den vom System generierten Prozess- oder Threadbezeichner.

Rückgabewert

Typ: Microsoft.VisualStudio.Profiler.NameOperationResult
Der Rückgabewert NameOperationResult ist eine Enumeration.

Hinweise

Jedem Prozess oder Thread kann nur ein Name zugewiesen werden. Nachdem einem Profilelement ein Name zugeordnet worden ist, werden nachfolgende Aufrufe von NameProfile für dieses Element ignoriert.

Wird verschiedenen Threads oder Prozessen derselbe Name zugewiesen, enthält der Bericht Daten von allen Elementen dieses Namens auf der betreffenden Ebene.

Wenn Sie einen anderen als den aktuellen Prozess oder Thread angeben, müssen Sie sicherstellen, dass dieser initialisiert und gestartet wurde, bevor Sie einen Namen zuweisen. Andernfalls schlägt die NameProfile-Methode fehl. Sowohl die CreateProcess()-API-Funktion als auch die CreateThread()-API-Funktion können zurückgegeben werden, bevor der Thread oder Prozess initialisiert wird.

Beispiele

Das folgende Beispiel veranschaulicht die NameProfile-Methode.

        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);
        }

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

DataCollection Klasse

Microsoft.VisualStudio.Profiler-Namespace

Freigeben über