PerformanceCounter.NextSample メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カウンター サンプルを取得し、生の、つまり計算されない値を返します。
public:
System::Diagnostics::CounterSample NextSample();public System.Diagnostics.CounterSample NextSample ();member this.NextSample : unit -> System.Diagnostics.CounterSamplePublic Function NextSample () As CounterSample戻り値
このカウンターのためにシステムで取得された値の、次の生の値を表す CounterSample。
例外
インスタンスがパフォーマンス カウンターに正しく関連付けられていません。
- または -
グローバル共有メモリを使用する場合、InstanceLifetime プロパティは Process に設定されます。
システム API にアクセス中にエラーが発生しました。
管理特権を使用せずに実行されているコードがパフォーマンス カウンターの読み取りを試みました。
例
次のコード例では、 メソッドを使用して、カウンターの NextSample 次の計算されていない値を取得する方法を示します。 このコード例は、 クラスの大きな例の 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
注釈
このメソッドは、一般に、計算されていない値を含むカウンターに使用されます。
注意
プロパティの値InstanceLifetimeが でProcess、パフォーマンス カウンター カテゴリがバージョン 1.0 または 1.1 .NET Framework作成された場合は、 InvalidOperationException がスローされます。 以前のバージョンで作成されたパフォーマンス カウンター カテゴリではグローバル共有メモリが使用され、 の InstanceLifetime 値は である Global必要があります。 .NET Frameworkのバージョン 1.0 または 1.1 で実行されているアプリケーションでカテゴリが使用されていない場合は、カテゴリを削除して再作成します。
注意
Windows Vista、Windows XP Professional x64 Edition、または Windows Server 2003 のパフォーマンス カウンターを読み取る場合は、パフォーマンス モニター Users グループのメンバーであるか、管理者権限を持っている必要があります。
Windows Vista のパフォーマンス カウンターにアクセスするために特権を昇格させる必要がないようにするには、パフォーマンス モニター Users グループに自分を追加します。
Windows Vista では、ユーザー アカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。 ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。 既定では、ユーザーは標準ユーザー ロールに所属します。 パフォーマンス カウンターにアクセスするコードを実行するには、まず特権を標準ユーザーから管理者に昇格させる必要があります。 この操作は、アプリケーションの起動時にアプリケーション アイコンを右クリックし、管理者として実行することを指定して行うことができます。
適用対象
.NET