PerformanceCounter Construtores

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacote:

System.Diagnostics.PerformanceCounter v8.0.0

Inicializa uma nova instância da classe PerformanceCounter.

Sobrecargas

PerformanceCounter()	Inicializa uma nova instância somente leitura da classe PerformanceCounter, sem associar a instância a nenhum sistema ou contador de desempenho personalizado.
PerformanceCounter(String, String)	Inicializa uma instância nova e somente leitura da classe PerformanceCounter e a associa ao contador de desempenho personalizado ou do sistema, especificado no computador local. Este construtor requer que a categoria de tenha uma única instância.
PerformanceCounter(String, String, Boolean)	Inicializa uma instância nova e somente leitura ou de leitura/gravação da classe PerformanceCounter e a associa ao contador de desempenho personalizado ou do sistema especificado no computador local. Este construtor requer que a categoria contenha uma única instância.
PerformanceCounter(String, String, String)	Inicializa uma instância nova e somente leitura da classe PerformanceCounter e a 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 e somente leitura ou de leitura/gravação da classe PerformanceCounter e a 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 instância nova e somente leitura da classe PerformanceCounter e a 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 classe PerformanceCounter, sem associar a instância a nenhum 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 de propriedade , CounterNamee InstanceName são definidos e os resultados de uma chamada para o NextValue método são exibidos.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

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 as CategoryNamepropriedades , CounterNamee InstanceName como cadeias de caracteres vazias ("" ) e define a MachineName propriedade como 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 as CategoryNamepropriedades , CounterNamee, opcionalmente, e InstanceNameMachineName antes de ler 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. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a HostProtectionAttribute classe ou SQL Server Atributos de Programação e Proteção de Host.

PerformanceCounter(String, String)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova e somente leitura da classe PerformanceCounter e a associa ao contador de desempenho personalizado ou do sistema, especificado no computador local. Este construtor requer que a categoria de 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 de contador de desempenho (objeto de desempenho) ao qual este 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 diferentes idiomas.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Um código em execução 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 contém várias instâncias, o construtor gerará uma exceção. Essa sobrecarga pode acessar qualquer contador somente leitura ou leitura/gravação, mas faz isso 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 de leitura/gravação.

Essa sobrecarga do construtor define as CategoryName propriedades e CounterName 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 as CategoryName propriedades e CounterName 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 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 Monitor de Desempenho Usuários.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do 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 você deseja executar como administrador.

PerformanceCounter(String, String, Boolean)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova e somente leitura ou de leitura/gravação da classe PerformanceCounter e a associa ao contador de desempenho personalizado ou do sistema especificado no computador local. Este 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 de contador de desempenho (objeto de desempenho) ao qual este 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

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

- ou -

O 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 diferentes idiomas.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Um código em execução 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 indicando que o contador não é somente leitura. Este exemplo de código faz parte de um exemplo maior para a PerformanceCounter classe .

PC = gcnew PerformanceCounter( "AverageCounter64SampleCategory","AverageCounter64Sample",false );

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 contém várias instâncias, o construtor gerará uma exceção.

Essa sobrecarga do construtor define as CategoryNamepropriedades , CounterNamee ReadOnly para os valores que você passa, define a MachineName propriedade como 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 as CategoryName propriedades e CounterName devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho para a qual 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, definir readOnly como false ao 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 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 Monitor de Desempenho Usuários.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do 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 você deseja executar como administrador.

PerformanceCounter(String, String, String)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova e somente leitura da classe PerformanceCounter e a 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 de contador de desempenho (objeto de desempenho) ao qual este 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 diferentes idiomas.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Um código em execução 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 as CategoryNamepropriedades , CounterNamee InstanceName 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 as CategoryNamepropriedades , CounterNamee InstanceName devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho para a qual 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 Monitor de Desempenho Usuários 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 Monitor de Desempenho Usuários.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do 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 você deseja executar como administrador.

PerformanceCounter(String, String, String, Boolean)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova e somente leitura ou de leitura/gravação da classe PerformanceCounter e a 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 de contador de desempenho (objeto de desempenho) ao qual este 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 e 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 configuração de permissão de leitura/gravação solicitada é inválida para esse 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 diferentes idiomas.

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Um código em execução 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 as CategoryNamepropriedades , CounterNamee InstanceName 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 as CategoryNamepropriedades , CounterNamee InstanceName devem apontar para um contador de desempenho existente no computador local. Se a instância do contador de desempenho para a qual 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, definir readOnly como false ao 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 Monitor de Desempenho Usuários 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 Monitor de Desempenho Usuários.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do 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 você deseja executar como administrador.

PerformanceCounter(String, String, String, String)

Origem:

PerformanceCounter.cs

Inicializa uma instância nova e somente leitura da classe PerformanceCounter e a 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 de contador de desempenho (objeto de desempenho) ao qual este 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 configuração de permissão de leitura/gravação solicitada é inválida para esse 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 diferentes idiomas.

ArgumentException

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

ArgumentNullException

categoryName ou counterName é null.

Win32Exception

Ocorreu um erro ao acessar uma API do sistema.

UnauthorizedAccessException

Um código em execução 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 as CategoryNamepropriedades , CounterNameInstanceName, e MachineName 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 as CategoryNamepropriedades , CounterNameInstanceName e MachineName devem apontar para um contador de desempenho existente. Se a instância do contador de desempenho para a qual 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 faz isso 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 de leitura/gravação.

Observação

Não é possível gravar em contadores de desempenho remotos. Não há sobrecarga que permita especificar 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 Monitor de Desempenho Usuários 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 Monitor de Desempenho Usuários.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do 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 você 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.