Freigeben über

PerformanceCounter.RawValue-Eigenschaft

Ruft den unformatierten bzw. nicht berechneten Wert dieses Zählers ab oder legt diesen fest.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property RawValue As Long
'Usage
Dim instance As PerformanceCounter
Dim value As Long

value = instance.RawValue

instance.RawValue = value

public long RawValue { get; set; }

public:
property long long RawValue {
    long long get ();
    void set (long long value);
}

/** @property */
public long get_RawValue ()

/** @property */
public void set_RawValue (long value)

public function get RawValue () : long

public function set RawValue (value : long)

Eigenschaftenwert

Der Rohwert des Zählers.

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

Sie versuchen, den Rohwert des Zählers festzulegen, der Zähler ist jedoch schreibgeschützt.

– oder –

Die Instanz ist keinem Leistungsindikator ordnungsgemäß zugeordnet.

- oder -

Die InstanceLifetime-Eigenschaft wird auf Process festgelegt, wenn der globale gemeinsam genutzte Speicherbereich verwendet wird.

Win32Exception

Fehler beim Zugriff auf eine System-API.

PlatformNotSupportedException

Die Plattform ist Windows 98 oder Windows Millennium Edition (Me), die keine Leistungsindikatoren unterstützen.

Hinweise

Wenn Sie versuchen, diese Eigenschaft für einen 32-Bit-Zähler auf einen zu großen Wert festzulegen, wird der Wert von der Eigenschaft auf 32 Bit verkürzt. Wenn Sie benutzerdefinierte Zähler auf dem lokalen Computer nicht über einen berechneten Wert, sondern mithilfe der RawValue-Eigenschaft lesen, kann die Leistung in solchen Szenarien deutlich verbessert werden, in denen der Rohwert ausreichend ist.

Beim Lesen eines schreibgeschützten Zählers wird durch Abrufen der RawValue-Eigenschaft zum Zeitpunkt des Abrufs eine Zählermessung durchgeführt. Diese Aktion entspricht einem ersten Aufruf der NextSample-Methode. Wenn Sie anschließend NextSample aufrufen, können Sie Berechnungen für die von beiden Aufrufen zurückgegebenen Werte durchführen.

Da Systemzähler schreibgeschützt sind, können Sie deren Rohwerte nur abrufen, jedoch nicht festlegen.

Hinweis

Die Methoden Increment, IncrementBy und Decrement verwendet Interlocks zum Aktualisieren des Zählerwerts. Dies erhöht die Genauigkeit des Zählerwerts in Szenarien mit mehreren Threads oder Prozessen, wirkt sich jedoch negativ auf die Leistung aus. Wenn Sie die Genauigkeit von Interlockoperationen nicht benötigen, können Sie die RawValue-Eigenschaft direkt aktualisieren, woraus sich eine bis zu fünffache Leistungsverbesserung ergibt. Szenarien mit mehreren Threads werden möglicherweise einige Aktualisierungen des Zählerwerts ignoriert, was zu ungenauen Daten führt.

Hinweis

Wenn der Wert für die InstanceLifetime-Eigenschaft Process ist und die Leistungsindikatorkategorie mit .NET Framework, Version 1.0 oder 1.1, erstellt wurde, wird eine InvalidOperationException ausgelöst. Leistungsindikatorkategorien, die mit früheren Versionen erstellt wurden, verwenden den globalen gemeinsam genutzten Speicherbereich, und der Wert für InstanceLifetime muss Global sein. Wenn die Kategorie von Anwendungen unter Version 1.0 oder 1.1 von .NET Framework nicht verwendet wird, löschen Sie die Kategorie, und erstellen Sie sie dann neu.

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PerformanceCounter-Klasse
PerformanceCounter-Member
System.Diagnostics-Namespace

  • Last updated on