PerformanceCounter.IncrementBy(Int64) メソッド

  • リファレンス

定義

名前空間:
System.Diagnostics
アセンブリ:
System.Diagnostics.PerformanceCounter.dll
アセンブリ:
System.dll

有効な分割不可能な操作を通じて、関連付けられたパフォーマンス カウンターの値を指定した量ずつインクリメントまたはデクリメントします。

public:
 long IncrementBy(long value);
public long IncrementBy (long value);
member this.IncrementBy : int64 -> int64
Public Function IncrementBy (value As Long) As Long

パラメーター

value
Int64

インクリメントする値の単位。 負の値を指定すると、カウンターはデクリメントされます。

戻り値

Int64

新しいカウンター値。

例外

InvalidOperationException

カウンターは読み取り専用です。そのため、アプリケーションによるインクリメントができません。

  • または - インスタンスがパフォーマンス カウンターに正しく関連付けられていません。

  • または - グローバル共有メモリを使用する場合、InstanceLifetime プロパティは Process に設定されます。

Win32Exception

システム API にアクセス中にエラーが発生しました。

例

次のコード例は、メソッドを使用 IncrementBy してカウンターにインクリメントを追加する方法を示しています。 このコード例は、クラスのより大きな例の PerformanceCounter 一部です。

void CollectSamples( ArrayList^ samplesList, PerformanceCounter^ PC, PerformanceCounter^ BPC )
{
   Random^ r = gcnew Random( DateTime::Now.Millisecond );

   // Loop for the samples.
   for ( int j = 0; j < 100; j++ )
   {
      int value = r->Next( 1, 10 );
      Console::Write( "{0} = {1}", j, value );
      PC->IncrementBy( value );
      BPC->Increment();
      if ( (j % 10) == 9 )
      {
         OutputSample( PC->NextSample() );
         samplesList->Add( PC->NextSample() );
      }
      else
            Console::WriteLine();
      System::Threading::Thread::Sleep( 50 );
   }
}

private static void CollectSamples(ArrayList samplesList)
{

    Random r = new Random( DateTime.Now.Millisecond );

    // Loop for the samples.
    for (int j = 0; j < 100; j++)
    {

        int value = r.Next(1, 10);
        Console.Write(j + " = " + value);

        avgCounter64Sample.IncrementBy(value);

        avgCounter64SampleBase.Increment();

        if ((j % 10) == 9)
        {
            OutputSample(avgCounter64Sample.NextSample());
            samplesList.Add( avgCounter64Sample.NextSample() );
        }
        else
        {
            Console.WriteLine();
        }

        System.Threading.Thread.Sleep(50);
    }
}

Private Shared Sub CollectSamples(ByVal samplesList As ArrayList)

    Dim r As New Random(DateTime.Now.Millisecond)

    ' Loop for the samples.
    Dim j As Integer
    For j = 0 To 99

        Dim value As Integer = r.Next(1, 10)
        Console.Write(j.ToString() + " = " + value.ToString())

        avgCounter64Sample.IncrementBy(value)

        avgCounter64SampleBase.Increment()

        If j Mod 10 = 9 Then
            OutputSample(avgCounter64Sample.NextSample())
            samplesList.Add(avgCounter64Sample.NextSample())
        Else
            Console.WriteLine()
        End If
        System.Threading.Thread.Sleep(50)
    Next j
End Sub

注釈

カスタム カウンターにのみ書き込むことができます。 すべてのシステム カウンターは読み取り専用です。

注意

IncrementBy、およびDecrementメソッドはIncrement、インターロックを使用してカウンター値を更新します。 これは、マルチスレッドまたはマルチプロセスのシナリオでカウンター値を正確に保つのに役立ちますが、パフォーマンスの低下も生じます。 インターロックされた操作によって提供される精度が必要ない場合は、最大 5 倍の RawValue パフォーマンス向上のためにプロパティを直接更新できます。 ただし、マルチスレッドのシナリオでは、カウンター値の一部の更新が無視され、データが不正確になる可能性があります。

注意

プロパティの値InstanceLifetimeがProcess、.NET Framework バージョン 1.0 または 1.1 でパフォーマンス カウンター カテゴリが作成された場合は、an InvalidOperationException がスローされます。 以前のバージョンで作成されたパフォーマンス カウンター カテゴリはグローバル共有メモリを使用し、値 InstanceLifetime は Global. バージョン 1.0 または 1.1 の.NET Frameworkで実行されているアプリケーションでカテゴリが使用されていない場合は、カテゴリを削除して再作成します。

適用対象

スレッド セーフ

このメソッドはスレッド セーフです。