PerformanceCounter 생성자
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
PerformanceCounter 클래스의 새 인스턴스를 초기화합니다.
오버로드
| Name | Description |
|---|---|
| PerformanceCounter() |
인스턴스를 시스템 또는 사용자 지정 성능 카운터와 연결하지 않고 클래스의 PerformanceCounter 읽기 전용 인스턴스를 새로 초기화합니다. |
| PerformanceCounter(String, String) |
클래스의 읽기 전용 인스턴스를 새로 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터와 연결합니다. 이 생성자는 범주에 단일 인스턴스가 있어야 합니다. |
| PerformanceCounter(String, String, Boolean) |
클래스의 새 읽기 전용 또는 읽기/쓰기 인스턴스를 PerformanceCounter 초기화하고 로컬 컴퓨터의 지정된 시스템 또는 사용자 지정 성능 카운터와 연결합니다. 이 생성자는 범주에 단일 인스턴스가 포함되어야 합니다. |
| PerformanceCounter(String, String, String) |
클래스의 읽기 전용 인스턴스를 새로 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다. |
| PerformanceCounter(String, String, String, Boolean) |
클래스의 새 읽기 전용 또는 읽기/쓰기 인스턴스를 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다. |
| PerformanceCounter(String, String, String, String) |
클래스의 읽기 전용 인스턴스를 새로 초기화하고 지정된 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다. |
PerformanceCounter()
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
인스턴스를 시스템 또는 사용자 지정 성능 카운터와 연결하지 않고 클래스의 PerformanceCounter 읽기 전용 인스턴스를 새로 초기화합니다.
public:
PerformanceCounter();
public PerformanceCounter();
Public Sub New ()
예제
다음 코드 예제에서는 클래스의 기본 인스턴스를 PerformanceCounter 만듭니다. 인스턴스가 만들어 CategoryName지면 , CounterName및 InstanceName 속성 값이 설정되고 메서드에 대한 NextValue 호출 결과가 표시됩니다.
PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())
설명
생성자의 이 오버로드는 , 및 속성을 빈 문자열("")로 설정하고 CategoryName속성을 로컬 컴퓨터(".")로 설정합니다MachineName.InstanceNameCounterName
이 생성자는 성능 카운터를 초기화하지 않으므로 로컬 컴퓨터의 기존 카운터와 인스턴스를 연결하지 않습니다. 특정 성능 카운터를 가리키려면 다른 속성을 읽거나 카운터에서 읽으려고 시도하기 전에 필요에 CounterName따라 , 및 MachineNameInstanceName 속성을 설정합니다CategoryName. 성능 카운터에 쓰려면 속성을 false.로 설정합니다ReadOnly.
메모
이 멤버에 적용된 특성의 HostProtectionAttribute 속성 값Synchronization | SharedState은 다음과 같습니다.Resources 데스크톱 애플리케이션에는 HostProtectionAttribute 영향을 주지 않습니다(일반적으로 아이콘을 두 번 클릭하거나 명령을 입력하거나 브라우저에서 URL을 입력하여 시작됨). 자세한 내용은 클래스 또는 SQL Server 프로그래밍 및 호스트 보호 특성을 참조 HostProtectionAttribute 하세요.
적용 대상
PerformanceCounter(String, String)
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
클래스의 읽기 전용 인스턴스를 새로 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터와 연결합니다. 이 생성자는 범주에 단일 인스턴스가 있어야 합니다.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);
public PerformanceCounter(string categoryName, string counterName);
new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String)
매개 변수
- categoryName
- String
이 성능 카운터가 연결된 성능 카운터 범주(성능 개체)의 이름입니다.
- counterName
- String
성능 카운터의 이름입니다.
예외
categoryName 은 빈 문자열("")입니다.
-또는-
counterName 은 빈 문자열("")입니다.
-또는-
지정된 범주가 없습니다.
-또는-
지정된 범주는 다중 instance 표시되며 instance 이름으로 성능 카운터를 만들어야 합니다.
-또는-
categoryName 다양한 counterName 언어로 지역화되었습니다.
categoryName 또는 counterName .입니다 null.
시스템 API에 액세스할 때 오류가 발생했습니다.
관리 권한 없이 실행되는 코드가 성능 카운터를 읽으려고 했습니다.
설명
매개 변수 문자열은 대/소문자를 구분하지 않습니다.
이 오버로드를 사용하여 단일 성능 카운터 범주 인스턴스를 포함하는 범주에 속하는 로컬 컴퓨터의 카운터에 액세스합니다. 이 생성자를 사용하여 이 PerformanceCounter 인스턴스를 여러 인스턴스가 포함된 범주를 가리키려고 하면 생성자가 예외를 throw합니다. 이 오버로드는 모든 읽기 전용 또는 읽기/쓰기 카운터에 액세스할 수 있지만 읽기 전용 모드에서 액세스할 수 있습니다. PerformanceCounter 이 오버로드를 사용하여 만든 인스턴스는 카운터 자체가 읽기/쓰기인 경우에도 카운터에 쓸 수 없습니다.
생성자의 이 오버로드는 전달한 값으로 속성 및 속성을 설정하고CategoryName, 속성을 로컬 컴퓨터 "."로 설정하고MachineName, 속성을 빈 문자열("")로 설정합니다InstanceName.CounterName
이 생성자는 성능 카운터를 초기화하고 로컬 컴퓨터의 기존 카운터(시스템 또는 사용자 지정 카운터)와 인스턴스를 연결합니다. 및 CounterName 속성에 CategoryName 대해 전달하는 값은 로컬 컴퓨터의 기존 성능 카운터를 가리킵니다.
메모
Windows Vista 이상, Windows XP Professional x64 Edition 또는 Windows Server 2003의 비대화형 로그온 세션에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista의 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
적용 대상
PerformanceCounter(String, String, Boolean)
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
클래스의 새 읽기 전용 또는 읽기/쓰기 인스턴스를 PerformanceCounter 초기화하고 로컬 컴퓨터의 지정된 시스템 또는 사용자 지정 성능 카운터와 연결합니다. 이 생성자는 범주에 단일 인스턴스가 포함되어야 합니다.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);
public PerformanceCounter(string categoryName, string counterName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)
매개 변수
- categoryName
- String
이 성능 카운터가 연결된 성능 카운터 범주(성능 개체)의 이름입니다.
- counterName
- String
성능 카운터의 이름입니다.
- readOnly
- Boolean
true 읽기 전용 모드에서 카운터에 액세스하려면(카운터 자체는 읽기/쓰기가 가능하지만) false 는 읽기/쓰기 모드에서 카운터에 액세스합니다.
예외
categoryName 빈 문자열("")입니다.
-또는-
counterName 빈 문자열("")입니다.
-또는-
지정된 범주가 없습니다. (있는 true경우readOnly).
-또는-
지정된 범주가 .NET Framework 사용자 지정 범주(있는 경우 readOnly )가 false아닙니다.
-또는-
지정된 범주는 다중 instance 표시되며 instance 이름으로 성능 카운터를 만들어야 합니다.
-또는-
categoryName 다양한 counterName 언어로 지역화되었습니다.
categoryName 또는 counterName .입니다 null.
시스템 API에 액세스할 때 오류가 발생했습니다.
관리 권한 없이 실행되는 코드가 성능 카운터를 읽으려고 했습니다.
예제
다음 코드 예제에서는 클래스의 인스턴스를 PerformanceCounter 만듭니다. 이 예제에서는 범주 이름, 카운터 이름 및 카운터가 읽기 전용이 아님을 나타내는 플래그 값을 전달합니다. 이 코드 예제는 클래스에 대한 더 큰 예제의 PerformanceCounter 일부입니다.
avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
"AverageCounter64Sample",
false);
avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)
설명
매개 변수 문자열은 대/소문자를 구분하지 않습니다.
이 오버로드를 사용하여 단일 성능 카운터 범주 인스턴스를 포함하는 범주에 속하는 로컬 컴퓨터의 읽기 전용 또는 읽기/쓰기 카운터에 액세스합니다. 이 생성자를 사용하여 이 PerformanceCounter 인스턴스를 여러 인스턴스가 포함된 범주를 가리키려고 하면 생성자가 예외를 throw합니다.
생성자의 이 오버로드는 전달한 값으로 , 및 속성을 설정하고CategoryName, 속성을 로컬 컴퓨터 "."로 설정하고MachineName, 속성을 빈 문자열("")로 설정합니다InstanceName.ReadOnlyCounterName
이 생성자는 성능 카운터를 초기화하고 로컬 컴퓨터의 기존 카운터(시스템 또는 사용자 지정 카운터)와 인스턴스를 연결합니다. 및 CounterName 속성에 CategoryName 대해 전달하는 값은 로컬 컴퓨터의 기존 성능 카운터를 가리킵니다. 가리키는 성능 카운터 인스턴스가 유효하지 않으면 생성자를 호출하면 예외가 throw됩니다.
메모
이 오버로드를 사용하여 시스템 카운터에 연결할 수 있지만 시스템 카운터에 쓸 수는 없습니다. 따라서 readOnly 시스템 카운터에 false 연결할 때 설정하면 생성자가 예외를 throw합니다.
메모
Windows Vista 이상, Windows XP Professional x64 Edition 또는 Windows Server 2003의 비대화형 로그온 세션에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista의 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
적용 대상
PerformanceCounter(String, String, String)
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
클래스의 읽기 전용 인스턴스를 새로 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);
public PerformanceCounter(string categoryName, string counterName, string instanceName);
new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String)
매개 변수
- categoryName
- String
이 성능 카운터가 연결된 성능 카운터 범주(성능 개체)의 이름입니다.
- counterName
- String
성능 카운터의 이름입니다.
- instanceName
- String
범주에 단일 인스턴스가 포함된 경우 성능 카운터 범주 인스턴스의 이름 또는 빈 문자열("")입니다.
예외
categoryName 은 빈 문자열("")입니다.
-또는-
counterName 은 빈 문자열("")입니다.
-또는-
지정된 범주가 잘못되었습니다.
-또는-
지정된 범주는 다중 instance 표시되며 instance 이름으로 성능 카운터를 만들어야 합니다.
-또는-
instanceName 가 127자보다 깁니다.
-또는-
categoryName 다양한 counterName 언어로 지역화되었습니다.
categoryName 또는 counterName .입니다 null.
시스템 API에 액세스할 때 오류가 발생했습니다.
관리 권한 없이 실행되는 코드가 성능 카운터를 읽으려고 했습니다.
설명
매개 변수 문자열은 대/소문자를 구분하지 않습니다.
생성자의 이 오버로드는 전달한 값으로 , CounterName및 InstanceName 속성을 설정하고 CategoryName속성을 로컬 컴퓨터 "."로 설정합니다MachineName.
이 생성자는 성능 카운터를 초기화하고 로컬 컴퓨터의 기존 카운터(시스템 또는 사용자 지정 카운터)와 인스턴스를 연결합니다. 및 CounterNameInstanceName 속성에 CategoryName대해 전달하는 값은 로컬 컴퓨터의 기존 성능 카운터를 가리킵니다. 가리키는 성능 카운터 인스턴스가 유효하지 않으면 생성자를 호출하면 예외가 throw됩니다.
이 오버로드는 모든 읽기 전용 또는 읽기/쓰기 카운터에 액세스할 수 있지만 읽기 전용 모드에서 액세스할 수 있습니다. PerformanceCounter 이 오버로드를 사용하여 만든 인스턴스는 카운터 자체가 읽기/쓰기인 경우에도 카운터에 쓸 수 없습니다.
성능 범주 인스턴스를 만들려면 생성자에 지정 instanceNamePerformanceCounter 합니다. 지정된 instanceName 범주 인스턴스가 이미 있는 경우 새 개체는 기존 범주 인스턴스를 참조합니다.
메모
Windows Vista, Windows XP Professional x64 Edition 또는 Windows Server 2003에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista의 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
적용 대상
PerformanceCounter(String, String, String, Boolean)
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
클래스의 새 읽기 전용 또는 읽기/쓰기 인스턴스를 초기화하고 로컬 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);
public PerformanceCounter(string categoryName, string counterName, string instanceName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)
매개 변수
- categoryName
- String
이 성능 카운터가 연결된 성능 카운터 범주(성능 개체)의 이름입니다.
- counterName
- String
성능 카운터의 이름입니다.
- instanceName
- String
범주에 단일 인스턴스가 포함된 경우 성능 카운터 범주 인스턴스의 이름 또는 빈 문자열("")입니다.
- readOnly
- Boolean
true 읽기 전용 모드에서 카운터에 액세스하려면 false 읽기/쓰기 모드에서 카운터에 액세스하려면 입니다.
예외
categoryName 은 빈 문자열("")입니다.
-또는-
counterName 은 빈 문자열("")입니다.
-또는-
요청된 읽기/쓰기 권한 설정이 이 카운터에 유효하지 않습니다.
-또는-
지정된 범주가 존재하지 않습니다(있는 경우 readOnlytrue).
-또는-
지정된 범주가 .NET Framework 사용자 지정 범주(있는 경우 readOnly )가 false아닙니다.
-또는-
지정된 범주는 다중 instance 표시되며 instance 이름으로 성능 카운터를 만들어야 합니다.
-또는-
instanceName 가 127자보다 깁니다.
-또는-
categoryName 다양한 counterName 언어로 지역화되었습니다.
categoryName 또는 counterName .입니다 null.
시스템 API에 액세스할 때 오류가 발생했습니다.
관리 권한 없이 실행되는 코드가 성능 카운터를 읽으려고 했습니다.
설명
매개 변수 문자열은 대/소문자를 구분하지 않습니다.
이 오버로드를 사용하여 읽기 전용 또는 읽기/쓰기 모드에서 성능 카운터에 액세스합니다.
생성자의 이 오버로드는 , 및 속성을 전달한 값으로 설정하고 CategoryName속성을 로컬 컴퓨터 "."로 설정합니다MachineName.InstanceNameCounterName
이 생성자는 성능 카운터를 초기화하고 로컬 컴퓨터의 기존 카운터(시스템 또는 사용자 지정 카운터)와 인스턴스를 연결합니다. 및 CounterNameInstanceName 속성에 CategoryName대해 전달하는 값은 로컬 컴퓨터의 기존 성능 카운터를 가리킵니다. 가리키는 성능 카운터 인스턴스가 유효하지 않으면 생성자를 호출하면 예외가 throw됩니다.
메모
이 오버로드를 사용하여 시스템 카운터에 연결할 수 있지만 시스템 카운터에 쓸 수는 없습니다. 따라서 readOnly 시스템 카운터에 false 연결할 때 설정하면 생성자가 예외를 throw합니다.
성능 범주 인스턴스를 만들려면 생성자에 지정 instanceNamePerformanceCounter 합니다. 지정된 instanceName 범주 인스턴스가 이미 있는 경우 새 개체는 기존 범주 인스턴스를 참조합니다.
메모
Windows Vista, Windows XP Professional x64 Edition 또는 Windows Server 2003에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista의 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
적용 대상
PerformanceCounter(String, String, String, String)
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
- Source:
- PerformanceCounter.cs
클래스의 읽기 전용 인스턴스를 새로 초기화하고 지정된 컴퓨터의 PerformanceCounter 지정된 시스템 또는 사용자 지정 성능 카운터 및 범주 인스턴스와 연결합니다.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);
public PerformanceCounter(string categoryName, string counterName, string instanceName, string machineName);
new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)
매개 변수
- categoryName
- String
이 성능 카운터가 연결된 성능 카운터 범주(성능 개체)의 이름입니다.
- counterName
- String
성능 카운터의 이름입니다.
- instanceName
- String
범주에 단일 인스턴스가 포함된 경우 성능 카운터 범주 인스턴스의 이름 또는 빈 문자열("")입니다.
- machineName
- String
성능 카운터 및 관련 범주가 있는 컴퓨터입니다.
예외
categoryName 은 빈 문자열("")입니다.
-또는-
counterName 은 빈 문자열("")입니다.
-또는-
요청된 읽기/쓰기 권한 설정이 이 카운터에 유효하지 않습니다.
-또는-
지정된 컴퓨터에 카운터가 없습니다.
-또는-
지정된 범주는 다중 instance 표시되며 instance 이름으로 성능 카운터를 만들어야 합니다.
-또는-
instanceName 가 127자보다 깁니다.
-또는-
categoryName 다양한 counterName 언어로 지역화되었습니다.
machineName 매개 변수가 잘못되었습니다.
categoryName 또는 counterName .입니다 null.
시스템 API에 액세스할 때 오류가 발생했습니다.
관리 권한 없이 실행되는 코드가 성능 카운터를 읽으려고 했습니다.
설명
매개 변수 문자열은 대/소문자를 구분하지 않습니다.
생성자의 이 오버로드는 전달한 CategoryName값으로 , CounterName및 InstanceNameMachineName 속성을 설정합니다.
이 생성자는 성능 카운터를 초기화하고 지정된 컴퓨터의 기존 카운터(시스템 또는 사용자 지정 카운터)와 인스턴스를 연결합니다. 및 CounterNameInstanceNameMachineName 속성에 CategoryName대해 전달하는 값은 기존 성능 카운터를 가리킵니다. 가리키는 성능 카운터 인스턴스가 유효하지 않으면 생성자를 호출하면 예외가 throw됩니다. 이 오버로드는 모든 읽기 전용 또는 읽기/쓰기 카운터에 액세스할 수 있지만 읽기 전용 모드에서 액세스할 수 있습니다. PerformanceCounter 이 오버로드를 사용하여 만든 인스턴스는 카운터 자체가 읽기/쓰기인 경우에도 카운터에 쓸 수 없습니다.
메모
원격 성능 카운터에 쓸 수 없습니다. 원격 컴퓨터에 연결하는 클래스의 읽기/쓰기 인스턴스를 PerformanceCounter 지정할 수 있는 오버로드가 없습니다.
성능 범주 인스턴스를 만들려면 생성자에 지정 instanceNamePerformanceCounter 합니다. 지정된 instanceName 범주 인스턴스가 이미 있는 경우 새 개체는 기존 범주 인스턴스를 참조합니다.
메모
Windows Vista, Windows XP Professional x64 Edition 또는 Windows Server 2003에서 성능 카운터를 읽으려면 성능 모니터 사용자 그룹의 구성원이거나 관리 권한이 있어야 합니다.
Windows Vista의 성능 카운터에 액세스하기 위해 권한을 상승시킬 필요가 없도록 하려면 성능 모니터 사용자 그룹에 자신을 추가합니다.
Windows Vista에서 UAC(사용자 계정 컨트롤)는 사용자의 권한을 결정합니다. 기본 제공 관리자 그룹의 구성원인 경우 표준 사용자 액세스 토큰과 관리자 액세스 토큰이라는 두 개의 런타임 액세스 토큰이 할당됩니다. 기본적으로 표준 사용자 역할에 있습니다. 성능 카운터에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행하려는 경우 애플리케이션을 시작할 때 이 작업을 수행할 수 있습니다.
메모
Windows Vista에서 원격 컴퓨터가 작업 그룹의 구성원인 경우 로컬 사용자 계정이 필터링되지 않고 관리자 계정으로 승격될 수 있도록 UAC를 사용하지 않도록 설정해야 할 수 있습니다. 보안상의 이유로 UAC를 사용하지 않도록 설정하는 것이 최후의 수단이어야 합니다. UAC를 사용하지 않도록 설정하는 방법에 대한 자세한 내용은 사용자 계정 컨트롤 및 WMI를 참조하세요.