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

[アーティクル]
08/14/2007

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

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

構文

'宣言
Public Sub New ( _
    categoryName As String, _
    counterName As String, _
    instanceName As String _
)
'使用
Dim categoryName As String
Dim counterName As String
Dim instanceName As String

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

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

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

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

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

次の方法で共有