PerformanceCounter コンストラクター

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.PerformanceCounter.dll

アセンブリ:: System.dll

パッケージ:: System.Diagnostics.PerformanceCounter v6.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v7.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v8.0.0

パッケージ:: System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

PerformanceCounter クラスの新しいインスタンスを初期化します。

オーバーロード

PerformanceCounter()	システムパフォーマンスカウンターにもカスタムパフォーマンスカウンターにも関連付けずに、PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化します。
PerformanceCounter(String, String)	PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンターに関連付けます。このコンストラクターを使用するには、カテゴリに含まれるインスタンスが 1 つだけである必要があります。
PerformanceCounter(String, String, Boolean)	PerformanceCounter クラスの新しい読み取り専用インスタンスまたは読み取り/書き込み可能インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンターに関連付けます。このコンストラクターを使用するには、カテゴリに含まれるインスタンスが 1 つだけである必要があります。
PerformanceCounter(String, String, String)	PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。
PerformanceCounter(String, String, String, Boolean)	PerformanceCounter クラスの新しい読み取り専用インスタンスまたは読み書き可能なインスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。
PerformanceCounter(String, String, String, String)	PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、指定したコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。

PerformanceCounter()

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

システムパフォーマンスカウンターにもカスタムパフォーマンスカウンターにも関連付けずに、PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化します。

public:
 PerformanceCounter();

public PerformanceCounter ();

Public Sub New ()

例

次のコード例では、クラスの既定のインスタンスを PerformanceCounter 作成します。インスタンスが作成されると、および InstanceName プロパティのCounterName CategoryName値が設定され、メソッドのNextValue呼び出しの結果が表示されます。

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

注釈

コンストラクターのこのオーバーロードは、および InstanceName の各プロパティを空の文字列 ("") に設定CategoryName CounterNameし、プロパティをMachineNameローカルコンピューター (".") に設定します。

このコンストラクターはパフォーマンスカウンターを初期化しないため、インスタンスはローカルコンピューター上の既存のカウンターに関連付けされません。特定のパフォーマンスカウンターをポイントするには、他のプロパティをCategoryName CounterName読み取る前、またはカウンターから読み取ろうとする前に、InstanceNameおよびプロパティ (必要に応じて) と MachineName プロパティを設定します。パフォーマンスカウンターに書き込むには、プロパティを ReadOnly に false設定します。

注意

HostProtectionAttributeこのメンバーに適用される属性のプロパティ値は Resources です。 Synchronization | SharedState HostProtectionAttribute は、デスクトップアプリケーション (通常、アイコンのダブルクリック、コマンドの入力、またはブラウザーへの URL の入力により起動されます) には影響しません。詳細については、クラスまたは SQL Server プログラミング属性とホスト保護属性に関するページを参照してくださいHostProtectionAttribute。

適用対象

PerformanceCounter(String, String)

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンターに関連付けます。このコンストラクターを使用するには、カテゴリに含まれるインスタンスが 1 つだけである必要があります。

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);

public PerformanceCounter (string categoryName, string counterName);

new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String)

パラメーター

categoryName: String

このパフォーマンスカウンターが関連付けられているパフォーマンスカウンターカテゴリ (パフォーマンスオブジェクト) の名前。

counterName: String

パフォーマンスカウンターの名前です

例外

InvalidOperationException

categoryName が空の文字列 ("") です。

- または -

counterName が空の文字列 ("") です。

- または -

指定されたカテゴリが存在しません。

- または -

指定されたカテゴリは複数インスタンスとしてマークされており、インスタンス名を使用してパフォーマンスカウンターを作成する必要があります。

- または -

categoryName および counterName が異なる言語にローカライズされています。

ArgumentNullException

categoryName または counterName が null です。

Win32Exception

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

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

注釈

パラメーター文字列では、大文字と小文字は区別されません。

このオーバーロードを使用して、単一のパフォーマンスカウンターカテゴリインスタンスを含むカテゴリに属するローカルコンピューター上のカウンターにアクセスします。このコンストラクターを使用して、この PerformanceCounter インスタンスを複数のインスタンスを含むカテゴリを指そうとすると、コンストラクターは例外をスローします。このオーバーロードは、読み取り専用または読み取り/書き込みカウンターにアクセスできますが、読み取り専用モードでアクセスできます。 PerformanceCounterこのオーバーロードを使用して作成されたインスタンスは、カウンター自体が読み取り/書き込みであっても、カウンターに書き込めません。

コンストラクターのこのオーバーロードは、プロパティと CounterName プロパティを渡す値に設定CategoryNameし、プロパティをMachineNameローカルコンピューター "." に設定し、プロパティをInstanceName空の文字列 ("") に設定します。

このコンストラクターは、パフォーマンスカウンターを初期化し、インスタンスをローカルコンピューター上の既存のカウンター (システムまたはカスタムカウンター) に関連付けます。プロパティと CounterName プロパティにCategoryName渡す値は、ローカルコンピューター上の既存のパフォーマンスカウンターを指している必要があります。

注意

Windows Vista 以降、Windows XP Professional x64 Edition、または Windows Server 2003 の非対話型ログオンセッションからパフォーマンスカウンターを読み取るには、パフォーマンスモニター Users グループのメンバーであるか、管理者特権を持っている必要があります。

Windows Vista のパフォーマンスカウンターにアクセスするために特権を昇格させる必要がないようにするには、パフォーマンスモニター Users グループに自分を追加します。

Windows Vista では、ユーザーアカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザーアクセストークンおよび管理者アクセストークンの 2 つのランタイムアクセストークンが割り当てられています。既定では、ユーザーは標準ユーザーロールに所属します。パフォーマンスカウンターにアクセスするコードを実行するには、まず特権を標準ユーザーから管理者に昇格させる必要があります。この操作は、アプリケーションの起動時にアプリケーションアイコンを右クリックし、管理者として実行することを指定して行うことができます。

適用対象

PerformanceCounter(String, String, Boolean)

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

PerformanceCounter クラスの新しい読み取り専用インスタンスまたは読み取り/書き込み可能インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンターに関連付けます。このコンストラクターを使用するには、カテゴリに含まれるインスタンスが 1 つだけである必要があります。

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

パラメーター

categoryName: String

このパフォーマンスカウンターが関連付けられているパフォーマンスカウンターカテゴリ (パフォーマンスオブジェクト) の名前。

counterName: String

パフォーマンスカウンターの名前です

readOnly: Boolean

カウンターに (カウンター自身が読み取り/書き込み可能であっても) 読み取り専用モードでアクセスする場合は true。読み取り/書き込みモードでアクセスする場合は false。

例外

InvalidOperationException

categoryName が空の文字列 ("") です。

- または -

counterName が空の文字列 ("") です。

- または -

指定されたカテゴリが存在しません。 (readOnly が true の場合)

- または -

指定されたカテゴリは、.NET Framework カスタムカテゴリではありません (readOnly が false の場合)。

- または -

categoryName および counterName が異なる言語にローカライズされています。

ArgumentNullException

categoryName または counterName が null です。

Win32Exception

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

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

例

次のコード例では、クラスのインスタンスを PerformanceCounter 作成します。この例では、カテゴリ名、カウンター名、およびカウンターが読み取り専用ではないことを示すフラグ値を渡します。このコード例は、クラスの大きな例の PerformanceCounter 一部です。

PC = gcnew PerformanceCounter( "AverageCounter64SampleCategory","AverageCounter64Sample",false );

avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
    "AverageCounter64Sample",
    false);

avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

注釈

パラメーター文字列では、大文字と小文字は区別されません。

このオーバーロードを使用して、単一のパフォーマンスカウンターカテゴリインスタンスを含むカテゴリに属するローカルコンピューター上の読み取り専用または読み取り/書き込みカウンターにアクセスします。このコンストラクターを使用して、この PerformanceCounter インスタンスを複数のインスタンスを含むカテゴリを指そうとすると、コンストラクターは例外をスローします。

コンストラクターのこのオーバーロードは、、、およびの各プロパティを渡す値に設定CategoryNameしReadOnly、プロパティをMachineNameローカルコンピューター "." に設定し、プロパティをInstanceName空の文字列 ("") に設定します。 CounterName

注意

このオーバーロードを使用してシステムカウンターに接続できますが、システムカウンターに書き込むことはできません。したがって、システムカウンターに接続するときにをにfalse設定readOnlyすると、コンストラクターは例外をスローします。

注意

適用対象

PerformanceCounter(String, String, String)

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);

public PerformanceCounter (string categoryName, string counterName, string instanceName);

new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String)

パラメーター

categoryName: String

このパフォーマンスカウンターが関連付けられているパフォーマンスカウンターカテゴリ (パフォーマンスオブジェクト) の名前。

counterName: String

パフォーマンスカウンターの名前です

instanceName: String

パフォーマンスカウンターカテゴリインスタンスの名前。カテゴリに含まれるインスタンスが 1 つだけの場合は空の文字列 ("")。

例外

InvalidOperationException

categoryName が空の文字列 ("") です。

- または -

counterName が空の文字列 ("") です。

- または -

指定されたカテゴリが有効ではありません。

- または -

instanceName が 127 文字を超えています。

- または -

categoryName および counterName が異なる言語にローカライズされています。

ArgumentNullException

categoryName または counterName が null です。

Win32Exception

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

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

注釈

パラメーター文字列では、大文字と小文字は区別されません。

コンストラクターのこのオーバーロードは、、CounterName、および InstanceName の各プロパティを渡す値に設定CategoryNameし、プロパティをMachineNameローカルコンピューター "." に設定します。

このコンストラクターは、パフォーマンスカウンターを初期化し、インスタンスをローカルコンピューター上の既存のカウンター (システムまたはカスタムカウンター) に関連付けます。、、およびプロパティにCategoryName CounterName渡す値は、InstanceNameローカルコンピューター上の既存のパフォーマンスカウンターを指す必要があります。ポイントするパフォーマンスカウンターインスタンスが無効な場合、コンストラクターを呼び出すと例外がスローされます。

このオーバーロードは、読み取り専用または読み取り/書き込みカウンターにアクセスできますが、読み取り専用モードでアクセスできます。 PerformanceCounterこのオーバーロードを使用して作成されたインスタンスは、カウンター自体が読み取り/書き込みであっても、カウンターに書き込めません。

パフォーマンスカテゴリインスタンスを作成するには、コンストラクターにをinstanceNamePerformanceCounter指定します。で instanceName 指定されたカテゴリインスタンスが既に存在する場合、新しいオブジェクトは既存のカテゴリインスタンスを参照します。

注意

Windows Vista、Windows XP Professional x64 Edition、または Windows Server 2003 のパフォーマンスカウンターを読み取るには、パフォーマンスモニター Users グループのメンバーであるか、管理者特権を持っている必要があります。

適用対象

PerformanceCounter(String, String, String, Boolean)

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

PerformanceCounter クラスの新しい読み取り専用インスタンスまたは読み書き可能なインスタンスを初期化し、ローカルコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, string instanceName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

パラメーター

categoryName: String

このパフォーマンスカウンターが関連付けられているパフォーマンスカウンターカテゴリ (パフォーマンスオブジェクト) の名前。

counterName: String

パフォーマンスカウンターの名前です

instanceName: String

パフォーマンスカウンターカテゴリインスタンスの名前。カテゴリに含まれるインスタンスが 1 つだけの場合は空の文字列 ("")。

readOnly: Boolean

読み取り専用モードでカウンターにアクセスする場合は true。読み書き可能モードでアクセスする場合は false。

例外

InvalidOperationException

categoryName が空の文字列 ("") です。

- または -

counterName が空の文字列 ("") です。

- または -

要求された読み取り/書き込みアクセス許可の設定は、このカウンターでは無効です。

- または -

指定されたカテゴリが存在しません (readOnly が true の場合)。

- または -

指定されたカテゴリは、.NET Framework カスタムカテゴリではありません (readOnly が false の場合)。

- または -

instanceName が 127 文字を超えています。

- または -

categoryName および counterName が異なる言語にローカライズされています。

ArgumentNullException

categoryName または counterName が null です。

Win32Exception

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

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

注釈

パラメーター文字列では、大文字と小文字は区別されません。

読み取り専用モードまたは読み取り/書き込みモードでパフォーマンスカウンターにアクセスするには、このオーバーロードを使用します。

コンストラクターのこのオーバーロードは、、、および InstanceName の各プロパティを渡す値に設定CategoryNameし、プロパティをMachineNameローカルコンピューター "." に設定CounterNameします。

注意

適用対象

PerformanceCounter(String, String, String, String)

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

ソース:: PerformanceCounter.cs

PerformanceCounter クラスの新しい読み取り専用インスタンスを初期化し、指定したコンピューターの指定したシステムパフォーマンスカウンターまたはカスタムパフォーマンスカウンター、およびカテゴリインスタンスに関連付けます。

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);

public PerformanceCounter (string categoryName, string counterName, string instanceName, string machineName);

new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

パラメーター

categoryName: String

このパフォーマンスカウンターが関連付けられているパフォーマンスカウンターカテゴリ (パフォーマンスオブジェクト) の名前。

counterName: String

パフォーマンスカウンターの名前です

instanceName: String

パフォーマンスカウンターカテゴリインスタンスの名前。カテゴリに含まれるインスタンスが 1 つだけの場合は空の文字列 ("")。

machineName: String

パフォーマンスカウンターと、それに関連付けられているカテゴリが存在するコンピューター。

例外

InvalidOperationException

categoryName が空の文字列 ("") です。

- または -

counterName が空の文字列 ("") です。

- または -

要求された読み取り/書き込みアクセス許可の設定は、このカウンターでは無効です。

- または -

指定したコンピューター上にカウンターが存在しません。

- または -

instanceName が 127 文字を超えています。

- または -

categoryName および counterName が異なる言語にローカライズされています。

ArgumentException

machineName パラメーターが有効ではありません。

ArgumentNullException

categoryName または counterName が null です。

Win32Exception

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

UnauthorizedAccessException

管理特権を使用せずに実行されているコードがパフォーマンスカウンターの読み取りを試みました。

注釈

パラメーター文字列では、大文字と小文字は区別されません。

コンストラクターのこのオーバーロードは、 CategoryName、 CounterName、 InstanceName、および MachineName の各プロパティを渡す値に設定します。

このコンストラクターは、パフォーマンスカウンターを初期化し、指定されたコンピューター上の既存のカウンター (システムまたはカスタムカウンター) にインスタンスを関連付けます。、、およびプロパティにCategoryName CounterName InstanceName渡す値は、MachineName既存のパフォーマンスカウンターを指している必要があります。ポイントするパフォーマンスカウンターインスタンスが無効な場合、コンストラクターを呼び出すと例外がスローされます。このオーバーロードは、読み取り専用または読み取り/書き込みカウンターにアクセスできますが、読み取り専用モードでアクセスできます。 PerformanceCounterこのオーバーロードを使用して作成されたインスタンスは、カウンター自体が読み取り/書き込みであっても、カウンターに書き込めません。

注意

リモートパフォーマンスカウンターに書き込むことはできません。リモートコンピューターに接続するクラスの読み取り/書き込みインスタンスを PerformanceCounter 指定できるオーバーロードはありません。

注意

Windows Vista では、リモートコンピューターがワークグループのメンバーである場合は、ローカルユーザーアカウントがフィルター処理されず、管理者アカウントに昇格できるように UAC を無効にする必要がある場合があります。セキュリティ上の理由から、UAC を無効にすることは最後の手段である必要があります。 UAC の無効化の詳細については、「ユーザーアカウント制御と WMI」を参照してください。

適用対象

PerformanceCounter コンストラクター

定義

オーバーロード

PerformanceCounter()

例

注釈

適用対象

PerformanceCounter(String, String)

パラメーター

例外

注釈

適用対象

PerformanceCounter(String, String, Boolean)

パラメーター

例外

例

注釈

適用対象

PerformanceCounter(String, String, String)

パラメーター

例外

注釈

適用対象

PerformanceCounter(String, String, String, Boolean)

パラメーター

例外

注釈

適用対象

PerformanceCounter(String, String, String, String)

パラメーター

例外

注釈

適用対象

フィードバック

その他のリソース