PerformanceCounter Construtores

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Inicializa uma nova instância da classe PerformanceCounter.

Sobrecargas

Nome	Description
PerformanceCounter()	Inicializa uma nova instância somente leitura da PerformanceCounter classe, sem associar a instância a qualquer sistema ou contador de desempenho personalizado.
PerformanceCounter(String, String)	Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado no computador local. Esse construtor requer que a categoria tenha uma única instância.
PerformanceCounter(String, String, Boolean)	Inicializa uma instância nova, somente leitura ou leitura/gravação da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado no computador local. Esse construtor requer que a categoria contenha uma única instância.
PerformanceCounter(String, String, String)	Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria no computador local.
PerformanceCounter(String, String, String, Boolean)	Inicializa uma instância nova, somente leitura ou leitura/gravação da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria no computador local.
PerformanceCounter(String, String, String, String)	Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria, no computador especificado.

PerformanceCounter()

Origem:

PerformanceCounter.cs

Inicializa uma nova instância somente leitura da PerformanceCounter classe, sem associar a instância a qualquer sistema ou contador de desempenho personalizado.

public:
 PerformanceCounter();

public PerformanceCounter();

Public Sub New ()

Exemplos

O exemplo de código a seguir cria uma instância padrão da PerformanceCounter classe. Depois que a instância é criada, os CategoryNamevalores , CounterNamee InstanceName propriedade são definidos, e os resultados de uma chamada para o NextValue método são exibidos.

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())

Comentários

Essa sobrecarga do construtor define o CategoryName, CounterNamee InstanceName as propriedades como cadeias de caracteres vazias (""), e define a MachineName propriedade para o computador local, (".").

Esse construtor não inicializa o contador de desempenho, portanto, ele não associa a instância a um contador existente no computador local. Para apontar para um contador de desempenho específico, defina o CategoryName, CounterNamee, opcionalmente, as InstanceName propriedades e MachineName as propriedades antes de ler quaisquer outras propriedades ou tentar ler de um contador. Para gravar em um contador de desempenho, defina a ReadOnly propriedade como false.

Observação

O HostProtectionAttribute atributo aplicado a esse membro tem o seguinte Resources valor de propriedade: Synchronization | SharedState. Isso HostProtectionAttribute não afeta aplicativos da área de trabalho (que normalmente são iniciados clicando duas vezes em um ícone, digitando um comando ou inserindo uma URL em um navegador). Para obter mais informações, consulte a HostProtectionAttribute classe ou os atributos de programação e proteção de host do SQL Server.

PerformanceCounter(String, String)

Origem:

PerformanceCounter.cs

Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado no computador local. Esse construtor requer que a categoria tenha uma única instância.

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)

Parâmetros

categoryName

String

O nome da categoria do contador de desempenho (objeto de desempenho) ao qual esse contador de desempenho está associado.

counterName

String

O nome do contador de desempenho.

Exceções

InvalidOperationException

categoryName é uma cadeia de caracteres vazia ("").

- ou -

counterName é uma cadeia de caracteres vazia ("").

- ou -

A categoria especificada não existe.

- ou -

A categoria especificada está marcada como várias instâncias e requer que o contador de desempenho seja criado com um nome de instância.

- ou -

categoryName e counterName foram localizados em idiomas diferentes.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Comentários

As cadeias de caracteres de parâmetro não diferenciam maiúsculas de minúsculas.

Use essa sobrecarga para acessar um contador no computador local que pertence a uma categoria que contém uma única instância de categoria de contador de desempenho. Se você tentar usar esse construtor para apontar essa PerformanceCounter instância para uma categoria que contenha várias instâncias, o construtor gerará uma exceção. Essa sobrecarga pode acessar qualquer contador somente leitura ou leitura/gravação, mas o faz em um modo somente leitura. Uma PerformanceCounter instância criada usando essa sobrecarga não pode gravar no contador, mesmo que o próprio contador seja leitura/gravação.

Essa sobrecarga do construtor define as propriedades e CounterName os CategoryName valores que você passa, define a MachineName propriedade para o computador local, ".", e define a InstanceName propriedade como uma cadeia de caracteres vazia ("").

Esse construtor inicializa o contador de desempenho e associa a instância a um contador existente (um sistema ou um contador personalizado) no computador local. Os valores que você passa para o e CounterName as CategoryName propriedades devem apontar para um contador de desempenho existente no computador local.

Observação

Para ler contadores de desempenho de uma sessão de logon não interativa no Windows Vista e posterior, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

PerformanceCounter(String, String, Boolean)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova, somente leitura ou leitura/gravação da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado no computador local. Esse construtor requer que a categoria contenha uma única instância.

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)

Parâmetros

categoryName

String

O nome da categoria do contador de desempenho (objeto de desempenho) ao qual esse contador de desempenho está associado.

counterName

String

O nome do contador de desempenho.

readOnly

Boolean

true para acessar o contador no modo somente leitura (embora o próprio contador possa ser de leitura/gravação); false para acessar o contador no modo de leitura/gravação.

Exceções

InvalidOperationException

É categoryName uma cadeia de caracteres vazia ("").

- ou -

É counterName uma cadeia de caracteres vazia ("").

- ou -

A categoria especificada não existe. (se readOnly for true).

- ou -

A categoria especificada não é uma categoria personalizada do .NET Framework (se readOnly for false).

- ou -

A categoria especificada está marcada como várias instâncias e requer que o contador de desempenho seja criado com um nome de instância.

- ou -

categoryName e counterName foram localizados em idiomas diferentes.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Exemplos

O exemplo de código a seguir cria uma instância da PerformanceCounter classe. O exemplo passa nomes de categoria, nomes de contador e um valor de sinalizador que indica que o contador não é somente leitura. Este exemplo de código faz parte de um exemplo maior para a PerformanceCounter classe.

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

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

Comentários

As cadeias de caracteres de parâmetro não diferenciam maiúsculas de minúsculas.

Use essa sobrecarga para acessar um contador somente leitura ou leitura/gravação no computador local que pertence a uma categoria que contém uma única instância de categoria de contador de desempenho. Se você tentar usar esse construtor para apontar essa PerformanceCounter instância para uma categoria que contenha várias instâncias, o construtor gerará uma exceção.

Essa sobrecarga do construtor define o CategoryName, CounterNamee ReadOnly as propriedades para os valores que você passa, define a MachineName propriedade para o computador local, ".", e define a InstanceName propriedade como uma cadeia de caracteres vazia ("").

Esse construtor inicializa o contador de desempenho e associa a instância a um contador existente (um sistema ou um contador personalizado) no computador local. Os valores que você passa para o e CounterName as CategoryName propriedades devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho que você aponta não for válida, chamar o construtor gerará uma exceção.

Observação

Você pode usar essa sobrecarga para se conectar a um contador do sistema, mas não pode gravar em um contador do sistema. Portanto, a configuração readOnly ao false se conectar a um contador do sistema faz com que o construtor gere uma exceção.

Observação

Para ler contadores de desempenho de uma sessão de logon não interativa no Windows Vista e posterior, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

PerformanceCounter(String, String, String)

Origem:

PerformanceCounter.cs

Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria no computador local.

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)

Parâmetros

categoryName

String

O nome da categoria do contador de desempenho (objeto de desempenho) ao qual esse contador de desempenho está associado.

counterName

String

O nome do contador de desempenho.

instanceName

String

O nome da instância de categoria do contador de desempenho ou uma cadeia de caracteres vazia (""), se a categoria contiver uma única instância.

Exceções

InvalidOperationException

categoryName é uma cadeia de caracteres vazia ("").

- ou -

counterName é uma cadeia de caracteres vazia ("").

- ou -

A categoria especificada não é válida.

- ou -

A categoria especificada está marcada como várias instâncias e requer que o contador de desempenho seja criado com um nome de instância.

- ou -

instanceName tem mais de 127 caracteres.

- ou -

categoryName e counterName foram localizados em idiomas diferentes.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Comentários

As cadeias de caracteres de parâmetro não diferenciam maiúsculas de minúsculas.

Essa sobrecarga do construtor define o CategoryName, CounterNamee InstanceName as propriedades para os valores que você passa e define a MachineName propriedade para o computador local, ".".

Esse construtor inicializa o contador de desempenho e associa a instância a um contador existente (um sistema ou um contador personalizado) no computador local. Os valores que você passa para o CategoryName, CounterNamee InstanceName as propriedades devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho que você aponta não for válida, chamar o construtor gerará uma exceção.

Essa sobrecarga pode acessar qualquer contador somente leitura ou leitura/gravação, mas o faz em um modo somente leitura. Uma PerformanceCounter instância criada usando essa sobrecarga não pode gravar no contador, mesmo que o próprio contador seja leitura/gravação.

Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter construtor. Se a instância de categoria especificada por instanceName já existir, o novo objeto fará referência à instância de categoria existente.

Observação

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

PerformanceCounter(String, String, String, Boolean)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova, somente leitura ou leitura/gravação da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria no computador local.

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)

Parâmetros

categoryName

String

O nome da categoria do contador de desempenho (objeto de desempenho) ao qual esse contador de desempenho está associado.

counterName

String

O nome do contador de desempenho.

instanceName

String

O nome da instância de categoria do contador de desempenho ou uma cadeia de caracteres vazia (""), se a categoria contiver uma única instância.

readOnly

Boolean

true para acessar um contador no modo somente leitura; false para acessar um contador no modo de leitura/gravação.

Exceções

InvalidOperationException

categoryName é uma cadeia de caracteres vazia ("").

- ou -

counterName é uma cadeia de caracteres vazia ("").

- ou -

A definição de permissão de leitura/escrita pedida é inválida para este contador.

- ou -

A categoria especificada não existe (se readOnly for true).

- ou -

A categoria especificada não é uma categoria personalizada do .NET Framework (se readOnly for false).

- ou -

A categoria especificada está marcada como várias instâncias e requer que o contador de desempenho seja criado com um nome de instância.

- ou -

instanceName tem mais de 127 caracteres.

- ou -

categoryName e counterName foram localizados em idiomas diferentes.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Comentários

As cadeias de caracteres de parâmetro não diferenciam maiúsculas de minúsculas.

Use essa sobrecarga para acessar um contador de desempenho no modo somente leitura ou leitura/gravação.

Essa sobrecarga do construtor define o CategoryName, CounterNamee InstanceName as propriedades para os valores que você passa, ele e define a MachineName propriedade para o computador local, ".".

Esse construtor inicializa o contador de desempenho e associa a instância a um contador existente (um sistema ou um contador personalizado) no computador local. Os valores que você passa para o CategoryName, CounterNamee InstanceName as propriedades devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho que você aponta não for válida, chamar o construtor gerará uma exceção.

Observação

Você pode usar essa sobrecarga para se conectar a um contador do sistema, mas não pode gravar em um contador do sistema. Portanto, a configuração readOnly ao false se conectar a um contador do sistema faz com que o construtor gere uma exceção.

Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter construtor. Se a instância de categoria especificada por instanceName já existir, o novo objeto fará referência à instância de categoria existente.

Observação

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

PerformanceCounter(String, String, String, String)

Origem:

PerformanceCounter.cs

Inicializa uma nova instância somente leitura da classe e a PerformanceCounter associa ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria, no computador especificado.

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)

Parâmetros

categoryName

String

O nome da categoria do contador de desempenho (objeto de desempenho) ao qual esse contador de desempenho está associado.

counterName

String

O nome do contador de desempenho.

instanceName

String

O nome da instância de categoria do contador de desempenho ou uma cadeia de caracteres vazia (""), se a categoria contiver uma única instância.

machineName

String

O computador no qual o contador de desempenho e sua categoria associada existem.

Exceções

InvalidOperationException

categoryName é uma cadeia de caracteres vazia ("").

- ou -

counterName é uma cadeia de caracteres vazia ("").

- ou -

A definição de permissão de leitura/escrita pedida é inválida para este contador.

- ou -

O contador não existe no computador especificado.

- ou -

A categoria especificada está marcada como várias instâncias e requer que o contador de desempenho seja criado com um nome de instância.

- ou -

instanceName tem mais de 127 caracteres.

- ou -

categoryName e counterName foram localizados em idiomas diferentes.

ArgumentException

O machineName parâmetro não é válido.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Comentários

As cadeias de caracteres de parâmetro não diferenciam maiúsculas de minúsculas.

Essa sobrecarga do construtor define o CategoryName, CounterNamee InstanceNameMachineName as propriedades para os valores que você passa.

Esse construtor inicializa o contador de desempenho e associa a instância a um contador existente (um sistema ou um contador personalizado) no computador especificado. Os valores que você passa para o CategoryName, CounterNameInstanceName e MachineName as propriedades devem apontar para um contador de desempenho existente. Se a instância do contador de desempenho que você aponta não for válida, chamar o construtor gerará uma exceção. Essa sobrecarga pode acessar qualquer contador somente leitura ou leitura/gravação, mas o faz em um modo somente leitura. Uma PerformanceCounter instância criada usando essa sobrecarga não pode gravar no contador, mesmo que o próprio contador seja leitura/gravação.

Observação

Não é possível gravar em contadores de desempenho remotos. Não há sobrecarga que permita que você especifique uma instância de leitura/gravação da PerformanceCounter classe que se conecta a um computador remoto.

Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter construtor. Se a instância de categoria especificada por instanceName já existir, o novo objeto fará referência à instância de categoria existente.

Observação

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

Observação

No Windows Vista, quando o computador remoto é membro de um grupo de trabalho, talvez seja necessário desabilitar o UAC para que a conta de usuário local não seja filtrada e possa ser elevada a uma conta de administrador. Por motivos de segurança, desabilitar o UAC deve ser um último recurso. Para obter informações sobre como desabilitar o UAC, consulte Controle de Conta de Usuário e WMI.