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

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

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

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

構文

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

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

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

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

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

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 に設定すると、例外がスローされます。

使用例

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

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

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

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

次の方法で共有