PerformanceCounterCategory.Exists メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カテゴリがシステムに登録されているかどうかを判断します。
オーバーロード
| Exists(String) |
カテゴリがローカル コンピューターに登録されているかどうかを判断します。 |
| Exists(String, String) |
指定したコンピューター上にカテゴリが登録されているかどうかを判断します。 |
Exists(String)
カテゴリがローカル コンピューターに登録されているかどうかを判断します。
public:
static bool Exists(System::String ^ categoryName);public static bool Exists (string categoryName);static member Exists : string -> boolPublic Shared Function Exists (categoryName As String) As Booleanパラメーター
- categoryName
- String
検索するパフォーマンス カウンター カテゴリの名前。
戻り値
カテゴリが登録されている場合は true。それ以外の場合は false。
例外
categoryName パラメーターが null です。
categoryName パラメーターが空の文字列 ("") です。
基になるシステム API の呼び出しに失敗しました。
管理特権を使用せずに実行されているコードがパフォーマンス カウンターの読み取りを試みました。
例
次のコード例では、"orders" という名前の PerformanceCounterCategory オブジェクトが存在するかどうかを判断します。 そうでない場合は、2 つのパフォーマンス カウンターを PerformanceCounterCategory 含む オブジェクトを CounterCreationDataCollection 使用して オブジェクトを作成します。
if ( !PerformanceCounterCategory::Exists( "Orders" ) )
{
CounterCreationData^ milk = gcnew CounterCreationData;
milk->CounterName = "milk";
milk->CounterType = PerformanceCounterType::NumberOfItems32;
CounterCreationData^ milkPerSecond = gcnew CounterCreationData;
milkPerSecond->CounterName = "milk orders/second";
milkPerSecond->CounterType = PerformanceCounterType::RateOfCountsPerSecond32;
CounterCreationDataCollection^ ccds = gcnew CounterCreationDataCollection;
ccds->Add( milkPerSecond );
ccds->Add( milk );
PerformanceCounterCategory::Create( "Orders", "Number of processed orders", ccds );
}
if (!PerformanceCounterCategory.Exists("Orders"))
{
CounterCreationData milk = new CounterCreationData();
milk.CounterName = "milk";
milk.CounterType = PerformanceCounterType.NumberOfItems32;
CounterCreationData milkPerSecond = new CounterCreationData();
milkPerSecond.CounterName = "milk orders/second";
milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;
CounterCreationDataCollection ccds = new CounterCreationDataCollection();
ccds.Add(milkPerSecond);
ccds.Add(milk);
PerformanceCounterCategory.Create("Orders", "Number of processed orders",
PerformanceCounterCategoryType.SingleInstance, ccds);
}
If Not PerformanceCounterCategory.Exists("Orders") Then
Dim milk As New CounterCreationData()
milk.CounterName = "milk"
milk.CounterType = PerformanceCounterType.NumberOfItems32
Dim milkPerSecond As New CounterCreationData()
milkPerSecond.CounterName = "milk orders/second"
milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32
Dim ccds As New CounterCreationDataCollection()
ccds.Add(milkPerSecond)
ccds.Add(milk)
PerformanceCounterCategory.Create("Orders", "Number of processed orders", _
PerformanceCounterCategoryType.SingleInstance, ccds)
End If
注釈
メソッドを Exists 使用すると、マシン上のすべてのパフォーマンス カウンターが可用性をチェックしている間に、パフォーマンスが著しく低下する可能性があります。 パフォーマンス カウンターにのみ書き込む場合は、アプリケーションのインストール時にパフォーマンス カウンターを作成し、カウンターにアクセスするときにカテゴリが存在すると仮定することで、パフォーマンス カウンターのグローバル検索を回避できます。 パフォーマンス カウンターからの読み取り時にパフォーマンス カウンター検索を回避する方法はありません。
注意
Windows Vista 以降、Windows XP Professional x64 Edition、または Windows Server 2003 の非対話型ログオン セッションからパフォーマンス カウンターを読み取るには、パフォーマンス モニター Users グループのメンバーであるか、管理者特権を持っている必要があります。
Windows Vista 以降のパフォーマンス カウンターにアクセスするために特権を昇格させる必要がないようにするには、パフォーマンス モニター Users グループに自分自身を追加します。
Windows Vista 以降では、ユーザー アカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。 ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。 既定では、ユーザーは標準ユーザー ロールに所属します。 パフォーマンス カウンターにアクセスするコードを実行するには、まず特権を標準ユーザーから管理者に昇格させる必要があります。 この操作は、アプリケーションの起動時にアプリケーション アイコンを右クリックし、管理者として実行することを指定して行うことができます。
こちらもご覧ください
適用対象
Exists(String, String)
指定したコンピューター上にカテゴリが登録されているかどうかを判断します。
public:
static bool Exists(System::String ^ categoryName, System::String ^ machineName);public static bool Exists (string categoryName, string machineName);static member Exists : string * string -> boolPublic Shared Function Exists (categoryName As String, machineName As String) As Booleanパラメーター
- categoryName
- String
検索するパフォーマンス カウンター カテゴリの名前。
- machineName
- String
カテゴリを調べるコンピューターの名前。
戻り値
カテゴリが登録されている場合は true。それ以外の場合は false。
例外
categoryName パラメーターが null です。
基になるシステム API の呼び出しに失敗しました。
ネットワーク パスが見つかりません。
呼び出し元に、必要なアクセス許可がありません。
- または -
管理特権を使用せずに実行されているコードがパフォーマンス カウンターの読み取りを試みました。
例
次の例では、 という名前OrdersのオブジェクトがPerformanceCounterCategory存在するかどうかを判断します。 存在しない場合は、2 つのパフォーマンス カウンターを PerformanceCounterCategory 含む オブジェクトを CounterCreationDataCollection 使用して オブジェクトを作成します。
if ( !PerformanceCounterCategory::Exists( "Orders" ) )
{
CounterCreationData^ milk = gcnew CounterCreationData;
milk->CounterName = "milk";
milk->CounterType = PerformanceCounterType::NumberOfItems32;
CounterCreationData^ milkPerSecond = gcnew CounterCreationData;
milkPerSecond->CounterName = "milk orders/second";
milkPerSecond->CounterType = PerformanceCounterType::RateOfCountsPerSecond32;
CounterCreationDataCollection^ ccds = gcnew CounterCreationDataCollection;
ccds->Add( milkPerSecond );
ccds->Add( milk );
PerformanceCounterCategory::Create( "Orders", "Number of processed orders", ccds );
}
if (!PerformanceCounterCategory.Exists("Orders"))
{
CounterCreationData milk = new CounterCreationData();
milk.CounterName = "milk";
milk.CounterType = PerformanceCounterType.NumberOfItems32;
CounterCreationData milkPerSecond = new CounterCreationData();
milkPerSecond.CounterName = "milk orders/second";
milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;
CounterCreationDataCollection ccds = new CounterCreationDataCollection();
ccds.Add(milkPerSecond);
ccds.Add(milk);
PerformanceCounterCategory.Create("Orders", "Number of processed orders",
PerformanceCounterCategoryType.SingleInstance, ccds);
}
If Not PerformanceCounterCategory.Exists("Orders") Then
Dim milk As New CounterCreationData()
milk.CounterName = "milk"
milk.CounterType = PerformanceCounterType.NumberOfItems32
Dim milkPerSecond As New CounterCreationData()
milkPerSecond.CounterName = "milk orders/second"
milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32
Dim ccds As New CounterCreationDataCollection()
ccds.Add(milkPerSecond)
ccds.Add(milk)
PerformanceCounterCategory.Create("Orders", "Number of processed orders", _
PerformanceCounterCategoryType.SingleInstance, ccds)
End If
注釈
メソッドを Exists 使用すると、マシン上のすべてのパフォーマンス カウンターが可用性をチェックしている間に、パフォーマンスが著しく低下する可能性があります。 パフォーマンス カウンターにのみ書き込む場合は、アプリケーションのインストール時にパフォーマンス カウンターを作成し、カウンターにアクセスするときにカテゴリが存在すると仮定することで、パフォーマンス カウンターのグローバル検索を回避できます。 パフォーマンス カウンターからの読み取り時にパフォーマンス カウンター検索を回避する方法はありません。
注意
Windows Vista 以降、Windows XP Professional x64 Edition、または Windows Server 2003 の非対話型ログオン セッションからパフォーマンス カウンターを読み取るには、パフォーマンス モニター Users グループのメンバーであるか、管理者特権を持っている必要があります。
Windows Vista 以降のパフォーマンス カウンターにアクセスするために特権を昇格させる必要がないようにするには、パフォーマンス モニター Users グループに自分自身を追加します。
Windows Vista 以降では、ユーザー アカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。 ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。 既定では、ユーザーは標準ユーザー ロールに所属します。 パフォーマンス カウンターにアクセスするコードを実行するには、まず特権を標準ユーザーから管理者に昇格させる必要があります。 この操作は、アプリケーションの起動時にアプリケーション アイコンを右クリックし、管理者として実行することを指定して行うことができます。
こちらもご覧ください
適用対象
.NET