PerformanceCounter Construtores

Definição

Inicializa uma nova instância da PerformanceCounter classe.

Sobrecargas

Name Description
PerformanceCounter()

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

PerformanceCounter(String, String)

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

PerformanceCounter(String, String, Boolean)

Inicializa uma nova instância de apenas leitura ou leitura/escrita da PerformanceCounter classe e associa-a ao sistema especificado ou ao contador de desempenho personalizado no computador local. Este construtor exige que a categoria contenha uma única instância.

PerformanceCounter(String, String, String)

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

PerformanceCounter(String, String, String, Boolean)

Inicializa uma nova instância de apenas leitura ou leitura/escrita da PerformanceCounter classe e associa-a 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 apenas de leitura da PerformanceCounter classe e associa-a ao sistema especificado ou ao contador de desempenho personalizado e à instância de categoria, no computador especificado.

PerformanceCounter()

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

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

public:
 PerformanceCounter();
public PerformanceCounter();
Public Sub New ()

Exemplos

O exemplo de código seguinte cria uma instância padrão da PerformanceCounter classe. Após a criação da instância, CategoryNameos valores de , CounterName, e InstanceName propriedades são definidos, e os resultados de uma chamada ao 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())

Observações

Esta sobrecarga do construtor define as CategoryName, , e CounterName propriedades para cadeias vazias (""), e define a InstanceName propriedade para o computador localMachineName, (".").

Este construtor não inicializa o contador de desempenho, pelo que não associa a instância a um contador existente no computador local. Para apontar para um contador de desempenho específico, defina as CategoryNamepropriedades , CounterName, e, opcionalmente, InstanceName as propriedades e MachineName antes de ler quaisquer outras propriedades ou tentar ler a partir de um contador. Para escrever num contador de performance, defina a ReadOnly propriedade para false.

Note

O HostProtectionAttribute atributo aplicado a este membro tem o seguinte Resources valor de propriedade:Synchronization | SharedState . Isto HostProtectionAttribute não afeta aplicações de ambiente de trabalho (que normalmente são iniciadas com duplo clique num ícone, digitação de um comando ou introdução de um URL no navegador). Para mais informações, consulte a classe HostProtectionAttribute ou SQL Server Atributos de Programação e Proteção de Host.

Aplica-se a

PerformanceCounter(String, String)

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

Inicializa uma nova instância apenas de leitura da PerformanceCounter classe e associa-a ao sistema especificado ou ao contador de desempenho personalizado no computador local. Este construtor exige 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) com a qual este contador de desempenho está associado.

counterName
String

O nome do contador de desempenho.

Exceções

categoryName é uma cadeia vazia ("").

-ou-

counterName é uma cadeia vazia ("").

-ou-

A categoria especificada não existe.

-ou-

A categoria especificada é marcada como multi-instância e requer que o contador de desempenho seja criado com um nome de instância.

-ou-

categoryName e counterName foram localizadas para diferentes línguas.

categoryName ou counterName é null.

Ocorreu um erro ao aceder a uma API do sistema.

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

Observações

As cadeias de parâmetros não são sensíveis a maiúsculas e maiúsculas.

Utilize esta sobrecarga para aceder a um contador no computador local que pertence a uma categoria contendo uma única instância de categoria de contador de desempenho. Se tentar usar este construtor para apontar esta PerformanceCounter instância para uma categoria que contenha múltiplas instâncias, o construtor lança uma exceção. Esta sobrecarga pode aceder a qualquer contador de apenas leitura ou de leitura/escrita, mas faz-no em modo de apenas leitura. Uma PerformanceCounter instância criada usando esta sobrecarga não pode escrever no contador, mesmo que o próprio contador seja leitura/escrita.

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

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

Note

Para ler contadores de desempenho de uma sessão de login não interativa no Windows Vista e versões posteriores, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a 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.

Aplica-se a

PerformanceCounter(String, String, Boolean)

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

Inicializa uma nova instância de apenas leitura ou leitura/escrita da PerformanceCounter classe e associa-a ao sistema especificado ou ao contador de desempenho personalizado no computador local. Este construtor exige 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) com a qual este contador de desempenho está associado.

counterName
String

O nome do contador de desempenho.

readOnly
Boolean

true aceder ao contador em modo apenas de leitura (embora o próprio contador pudesse ser de leitura/escrita); false para aceder ao contador em modo leitura/escrita.

Exceções

É categoryName uma cadeia vazia ("").

-ou-

É counterName uma cadeia vazia ("").

-ou-

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

-ou-

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

-ou-

A categoria especificada é marcada como multi-instância e requer que o contador de desempenho seja criado com um nome de instância.

-ou-

categoryName e counterName foram localizadas para diferentes línguas.

categoryName ou counterName é null.

Ocorreu um erro ao aceder a uma API do sistema.

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

Exemplos

O seguinte exemplo de código cria uma instância da PerformanceCounter classe. O exemplo inclui nomes de categorias, nomes de contadores e um valor de bandeira que indica que o contador não é apenas de leitura. Este exemplo de código faz parte de um exemplo maior para a PerformanceCounter turma.

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

Observações

As cadeias de parâmetros não são sensíveis a maiúsculas e maiúsculas.

Use esta sobrecarga para aceder a um contador de apenas leitura ou de leitura/escrita no computador local que pertença a uma categoria contendo uma única instância de categoria de contador de desempenho. Se tentar usar este construtor para apontar esta PerformanceCounter instância para uma categoria que contenha múltiplas instâncias, o construtor lança uma exceção.

Esta sobrecarga do construtor define as CategoryNamepropriedades , CounterName, e ReadOnly para os valores que passa, define a MachineName propriedade para o computador local, ".", e define a InstanceName propriedade para uma cadeia vazia ("").

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

Note

Podes usar esta sobrecarga para te ligares a um contador de sistema, mas não podes escrever num contador de sistema. Portanto, definir readOnly para false ao ligar a um contador de sistema faz com que o construtor lance uma exceção.

Note

Para ler contadores de desempenho de uma sessão de login não interativa no Windows Vista e versões posteriores, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a 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.

Aplica-se a

PerformanceCounter(String, String, String)

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

Inicializa uma nova instância apenas de leitura da PerformanceCounter classe e associa-a 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) com a qual este contador de desempenho está associado.

counterName
String

O nome do contador de desempenho.

instanceName
String

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

Exceções

categoryName é uma cadeia vazia ("").

-ou-

counterName é uma cadeia vazia ("").

-ou-

A categoria especificada não é válida.

-ou-

A categoria especificada é marcada como multi-instância 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 localizadas para diferentes línguas.

categoryName ou counterName é null.

Ocorreu um erro ao aceder a uma API do sistema.

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

Observações

As cadeias de parâmetros não são sensíveis a maiúsculas e maiúsculas.

Esta sobrecarga do construtor define as CategoryNamepropriedades , CounterName, e InstanceName para os valores que passa, e define a MachineName propriedade para o computador local, ".".

Este construtor inicializa o contador de desempenho e associa a instância a um contador existente (seja um contador de sistema ou personalizado) no computador local. Os valores que passa para as CategoryNamepropriedades , CounterName, e InstanceName devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de performance a que apontas não for válida, chamar o construtor lança uma exceção.

Esta sobrecarga pode aceder a qualquer contador de apenas leitura ou de leitura/escrita, mas faz-no em modo de apenas leitura. Uma PerformanceCounter instância criada usando esta sobrecarga não pode escrever no contador, mesmo que o próprio contador seja leitura/escrita.

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 irá referenciar a instância de categoria existente.

Note

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a 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.

Aplica-se a

PerformanceCounter(String, String, String, Boolean)

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

Inicializa uma nova instância de apenas leitura ou leitura/escrita da PerformanceCounter classe e associa-a 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) com a qual este contador de desempenho está associado.

counterName
String

O nome do contador de desempenho.

instanceName
String

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

readOnly
Boolean

true aceder a um contador em modo apenas de leitura; false para aceder a um contador em modo leitura/escrita.

Exceções

categoryName é uma cadeia vazia ("").

-ou-

counterName é uma cadeia vazia ("").

-ou-

A definição de permissão de leitura/escrita solicitada é 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 .NET Framework (se readOnly for false).

-ou-

A categoria especificada é marcada como multi-instância 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 localizadas para diferentes línguas.

categoryName ou counterName é null.

Ocorreu um erro ao aceder a uma API do sistema.

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

Observações

As cadeias de parâmetros não são sensíveis a maiúsculas e maiúsculas.

Use esta sobrecarga para aceder a um contador de desempenho em modo apenas leitura ou leitura/escrita.

Esta sobrecarga do construtor define as CategoryNamepropriedades , CounterName, e InstanceName para os valores que passa em , it e define a MachineName propriedade para o computador local, ".".

Este construtor inicializa o contador de desempenho e associa a instância a um contador existente (seja um contador de sistema ou personalizado) no computador local. Os valores que passa para as CategoryNamepropriedades , CounterName, e InstanceName devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho a que apontas não for válida, chamar o construtor lança uma exceção.

Note

Podes usar esta sobrecarga para te ligares a um contador de sistema, mas não podes escrever num contador de sistema. Portanto, definir readOnly para false ao ligar a um contador de sistema faz com que o construtor lance 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 irá referenciar a instância de categoria existente.

Note

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a 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.

Aplica-se a

PerformanceCounter(String, String, String, String)

Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs
Origem:
PerformanceCounter.cs

Inicializa uma nova instância apenas de leitura da PerformanceCounter classe e associa-a 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) com a qual este contador de desempenho está associado.

counterName
String

O nome do contador de desempenho.

instanceName
String

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

machineName
String

O computador onde existe o contador de desempenho e a sua categoria associada.

Exceções

categoryName é uma cadeia vazia ("").

-ou-

counterName é uma cadeia vazia ("").

-ou-

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

-ou-

O contador não existe no computador especificado.

-ou-

A categoria especificada é marcada como multi-instância 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 localizadas para diferentes línguas.

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

categoryName ou counterName é null.

Ocorreu um erro ao aceder a uma API do sistema.

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

Observações

As cadeias de parâmetros não são sensíveis a maiúsculas e maiúsculas.

Esta sobrecarga do construtor define os CategoryName, CounterName, InstanceName, e MachineName propriedades para os valores que se passa.

Este construtor inicializa o contador de desempenho e associa a instância a um contador existente (seja um sistema ou um contador personalizado) no computador especificado. Os valores que passa para as CategoryNamepropriedades , CounterName, InstanceName e MachineName devem apontar para um contador de desempenho existente. Se a instância do contador de performance a que apontas não for válida, chamar o construtor lança uma exceção. Esta sobrecarga pode aceder a qualquer contador de apenas leitura ou de leitura/escrita, mas faz-no em modo de apenas leitura. Uma PerformanceCounter instância criada usando esta sobrecarga não pode escrever no contador, mesmo que o próprio contador seja leitura/escrita.

Note

Não podes escrever em contadores de desempenho remotos. Não há sobrecarga que permita especificar uma instância de leitura/escrita da PerformanceCounter classe que se liga 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 irá referenciar a instância de categoria existente.

Note

Para ler contadores de desempenho no Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, deve ser membro do grupo Performance Monitor Users ou ter privilégios administrativos.

Para evitar ter de elevar os seus privilégios para aceder a contadores de desempenho no Windows Vista, adicione-se ao grupo Performance Monitor Users.

No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede aos contadores de desempenho, deve primeiro elevar os seus privilégios de utilizador padrão a 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.

Note

No Windows Vista, quando o computador remoto é membro de um grupo de trabalho, pode ser necessário desativar o UAC para que a conta de utilizador local não seja filtrada e possa ser elevada para conta de administrador. Por razões de segurança, desativar o UAC deve ser o último recurso. Para informações sobre como desativar o UAC, consulte Controlo de Conta de Utilizador e WMI.

Aplica-se a