Partilhar via

Usando modelos de cadeia de caracteres padrão

  • Artigo

Vários consumidores, como o Consumidor de Evento de Script Ativo ou o Consumidor de Evento de Linha de Comando, têm propriedades de cadeia de caracteres com o qualificador Modelo. Essas propriedades usam modelos de cadeia de caracteres padrão para construir uma cadeia de caracteres que é configurada em parte pela instância do consumidor e em parte por um evento. A estrutura de um modelo de cadeia de caracteres padrão é semelhante à especificação da variável de ambiente do Microsoft Windows.

A lista a seguir mostra alguns exemplos do idioma do modelo:

  • A cadeia de texto "Some text here" sempre produz a cadeia de texto "Some text here".
  • "%CPUUtilization%" sempre produz o valor da CPUUtilization propriedade do evento a ser entregue. Se a propriedade não for uma cadeia de caracteres, ela será convertida em uma cadeia de caracteres; por exemplo, "90" ou "TRUE".
  • "A utilização da CPU deste processador está %CPUUtilization% no momento" incorpora o valor da propriedade CPUUtilization do evento na cadeia de caracteres, produzindo algo como, "A utilização da CPU deste processador é 90 no momento".
  • "%TargetInstance. CPUUtilization%" recupera o valor da propriedade CPUUtilization na instância incorporada da propriedade TargetInstance.
  • "%%" produz um único sinal %.
  • Se a propriedade que está sendo recuperada for uma matriz, toda a matriz será produzida no seguinte formato: "(1,5,10,1024)". Se houver apenas um elemento na matriz, os parênteses serão omitidos. Se não houver elementos na matriz, "()" será produzido.
  • Se uma propriedade for um objeto incorporado, a representação MOF do objeto será produzida (semelhante ao métodoIWbemClassObject::GetObjectText).
  • Se uma propriedade de uma matriz incorporada de objetos for solicitada, ela será tratada como uma propriedade com um valor de matriz. Por exemplo: %MyEvents. TargetInstance.DriverLetter% poderia produzir '("C:","D:")' se MyEvents for uma matriz de eventos de modificação de instância incorporados.

Literais de strings

Qualquer coisa dentro de um par de aspas é considerada uma string literal e não será substituída.

O exemplo a seguir mostra a string que o compilador vê para "a utilização da CPU é %CPUUtilization%".

CPU utilization is %CPUUtilization%

Essa cadeia de caracteres produz a seguinte saída.

CPU utilization is 90

Por outro lado, a string "CPU utilization is \"%CPUUtilization%\"" é vista pelo compilador da seguinte forma.

CPU utilization is "%CPUUtilization%"

Esta cadeia de caracteres produz a seguinte saída, sem substituição de variáveis.

CPU utilization is "%CPUUtilization%"

Monitoramento e Resposta a Eventos com Consumidores Padrão