PerformanceCounter コンストラクタ

.NET Framework クラス ライブラリ リファレンス

PerformanceCounter コンストラクタ (String, String, Boolean)

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim categoryName As String
Dim counterName As String
Dim readOnly As Boolean

Dim instance As New PerformanceCounter(categoryName,
 counterName, readOnly)

C#

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

C++

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

J#

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    boolean readOnly
)

JScript

public function PerformanceCounter (
    categoryName : String, 
    counterName : String, 
    readOnly : boolean
)

パラメータ

categoryName

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

counterName

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

readOnly

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

例外

例外の種類	条件
InvalidOperationException	categoryName が空の文字列 ("") です。 または counterName が空の文字列 ("") です。 または 指定されたカテゴリが存在しません。(readOnly が true の場合)。 または 指定されたカテゴリは、.NET Framework カスタム カテゴリではありません (readOnly が false の場合)。 または 指定されたカテゴリは複数インスタンスとしてマークされているため、インスタンス名を使用してパフォーマンス カウンタを作成する必要があります。
ArgumentNullException	categoryName パラメータまたは counterName パラメータが null 参照 (Visual Basic では Nothing) です。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

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

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

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

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

メモ
このオーバーロードを使用するとシステム カウンタに接続できますが、システム カウンタに書き込むことはできません。そのため、システム カウンタに接続するときに readOnly を false に設定すると、例外がスローされます。

使用例

Visual Basic

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

C#

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

C++

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

J#

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ (String, String, String, Boolean)

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim categoryName As String
Dim counterName As String
Dim instanceName As String
Dim readOnly As Boolean

Dim instance As New PerformanceCounter(categoryName,
 counterName, instanceName, readOnly)

C#

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

C++

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

J#

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    String instanceName, 
    boolean readOnly
)

JScript

public function PerformanceCounter (
    categoryName : String, 
    counterName : String, 
    instanceName : String, 
    readOnly : boolean
)

パラメータ

categoryName

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

counterName

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

instanceName

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

readOnly

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

例外

例外の種類	条件
InvalidOperationException	categoryName が空の文字列 ("") です。 または counterName が空の文字列 ("") です。 または 要求した読み取り/書き込みアクセス許可の設定は、このカウンタでは無効です。 または 指定されたカテゴリが存在しません。(readOnly が true の場合)。 または 指定されたカテゴリは、.NET Framework カスタム カテゴリではありません (readOnly が false の場合)。 または 指定されたカテゴリは複数インスタンスとしてマークされているため、インスタンス名を使用してパフォーマンス カウンタを作成する必要があります。 または instanceName が 127 文字を超えています。
ArgumentNullException	categoryName パラメータまたは counterName パラメータが null 参照 (Visual Basic では Nothing) です。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

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

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

このコンストラクタのオーバーロードによって、CategoryName、CounterName、InstanceName の各プロパティが渡された値に設定され、MachineName プロパティがローカル コンピュータ "." に設定されます。

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

メモ
このオーバーロードを使用するとシステム カウンタに接続できますが、システム カウンタに書き込むことはできません。そのため、システム カウンタに接続するときに readOnly を false に設定すると、例外がスローされます。

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ (String, String, String, String)

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim categoryName As String
Dim counterName As String
Dim instanceName As String
Dim machineName As String

Dim instance As New PerformanceCounter(categoryName,
 counterName, instanceName, machineName)

C#

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

C++

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

J#

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    String instanceName, 
    String machineName
)

JScript

public function PerformanceCounter (
    categoryName : String, 
    counterName : String, 
    instanceName : String, 
    machineName : String
)

パラメータ

categoryName

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

counterName

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

instanceName

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

machineName

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

例外

例外の種類	条件
InvalidOperationException	categoryName が空の文字列 ("") です。 または counterName が空の文字列 ("") です。 または 要求した読み取り/書き込みアクセス許可の設定は、このカウンタでは無効です。 または 指定したコンピュータ上にカウンタが存在しません。 または 指定されたカテゴリは複数インスタンスとしてマークされているため、インスタンス名を使用してパフォーマンス カウンタを作成する必要があります。 または instanceName が 127 文字を超えています。
ArgumentException	machineName パラメータが有効ではありません。
ArgumentNullException	categoryName パラメータまたは counterName パラメータが null 参照 (Visual Basic では Nothing) です。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

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

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

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

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

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ

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 メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ (String, String, String)

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim categoryName As String
Dim counterName As String
Dim instanceName As String

Dim instance As New PerformanceCounter(categoryName,
 counterName, instanceName)

C#

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

C++

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

J#

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    String instanceName
)

JScript

public function PerformanceCounter (
    categoryName : String, 
    counterName : String, 
    instanceName : String
)

パラメータ

categoryName

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

counterName

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

instanceName

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

例外

例外の種類	条件
InvalidOperationException	categoryName が空の文字列 ("") です。 または counterName が空の文字列 ("") です。 または 指定されたカテゴリが有効ではありません。 または 指定されたカテゴリは複数インスタンスとしてマークされているため、インスタンス名を使用してパフォーマンス カウンタを作成する必要があります。 または instanceName が 127 文字を超えています。
ArgumentNullException	categoryName パラメータまたは counterName パラメータが null 参照 (Visual Basic では Nothing) です。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

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

このコンストラクタのオーバーロードによって、CategoryName、CounterName、InstanceName の各プロパティが渡された値に設定され、MachineName プロパティがローカル コンピュータ "." に設定されます。

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

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

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ (String, String)

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim categoryName As String
Dim counterName As String

Dim instance As New PerformanceCounter(categoryName,
 counterName)

C#

public PerformanceCounter (
    string categoryName,
    string counterName
)

C++

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

J#

public PerformanceCounter (
    String categoryName, 
    String counterName
)

JScript

public function PerformanceCounter (
    categoryName : String, 
    counterName : String
)

パラメータ

categoryName

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

counterName

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

例外

例外の種類	条件
InvalidOperationException	categoryName が空の文字列 ("") です。 または counterName が空の文字列 ("") です。 または 指定されたカテゴリが存在しません。 または 指定されたカテゴリは複数インスタンスとしてマークされているため、インスタンス名を使用してパフォーマンス カウンタを作成する必要があります。
ArgumentNullException	categoryName パラメータまたは counterName パラメータが null 参照 (Visual Basic では Nothing) です。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

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

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

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

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間

PerformanceCounter コンストラクタ ()

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

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New PerformanceCounter

C#

public PerformanceCounter ()

C++

public:
PerformanceCounter ()

J#

public PerformanceCounter ()

JScript

public function PerformanceCounter ()

例外

例外の種類	条件
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

このコンストラクタのオーバーロードによって、CategoryName、CounterName、InstanceName の各プロパティが空の文字列 ("") に設定され、MachineName プロパティがローカル コンピュータ ("") に設定されます。

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

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

使用例

Visual Basic

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

C#

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

C++

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

J#

PerformanceCounter pc = new PerformanceCounter();
pc.set_CategoryName("Process");
pc.set_CounterName("Private Bytes");
pc.set_InstanceName("Explorer");
MessageBox.Show(((Single)pc.NextValue()).ToString());

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間