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

2007-08-14

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

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

構文

'宣言
Public Sub New ( _
    categoryName As String, _
    counterName As String, _
    instanceName As String, _
    readOnly As Boolean _
)
'使用
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)

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

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

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

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