PerformanceCounterCategory.Exists 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
범주가 시스템에 등록되어 있는지 여부를 확인합니다.
오버로드
| Name | Description |
|---|---|
| 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 확인합니다. 그렇지 않은 경우 두 개의 성능 카운터가 포함된 개체를 PerformanceCounterCategory 사용하여 개체를 만듭니다CounterCreationDataCollection.
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의 비대화형 로그온 세션에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista 이상에서 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista 이상에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
추가 정보
적용 대상
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에 대한 호출이 실패했습니다.
네트워크 경로를 찾을 수 없습니다.
예제
다음 예제에서는 명명 PerformanceCounterCategory 된 개체가 Orders 있는지 여부를 확인합니다. 이 개체가 없으면 두 개의 성능 카운터가 포함된 개체를 PerformanceCounterCategory 사용하여 개체를 만드는 CounterCreationDataCollection 예제입니다.
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의 비대화형 로그온 세션에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista 이상에서 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista 이상에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
