Uso de plantillas de cadena estándar
Varios consumidores, como el consumidor de eventos de script activo o el consumidor de eventos de la línea de comandos, tienen propiedades de cadena con el calificador Template (plantilla). Estas propiedades usan plantillas de cadena estándar para construir una cadena que la configura en parte la instancia del consumidor y en parte un evento. La estructura de una plantilla de cadena estándar es similar a la especificación de la variable de entorno de Microsoft Windows.
En la lista siguiente se muestran algunos ejemplos del lenguaje de plantilla:
- La cadena "Some text here" siempre genera la cadena "Some text here".
- "%CPUUtilization%" siempre genera el valor de la propiedad CPUUtilization del evento que se entrega. Si la propiedad no es una cadena, se convierte en una; por ejemplo, "90" o "TRUE".
- "The CPU utilization of this processor is %CPUUtilization% at this time" inserta el valor de la propiedad CPUUtilization del evento en la cadena, lo que produce algo parecido a "The CPU utilization of this processor is 90 at this time".
- "%TargetInstance.CPUUtilization%" recupera el valor de la propiedad CPUUtilization en la instancia insertada de la propiedad TargetInstance.
- "%%" genera un signo % único.
- Si la propiedad que se recupera es una matriz, toda la matriz se genera en el siguiente formato: "(1,5,10,1024)". Si solo hay un elemento en la matriz, se omiten los paréntesis. Si no hay ningún elemento en la matriz, se genera "()".
- Si una propiedad es un objeto incrustado, se genera la representación MOF del objeto (similar al método IWbemClassObject::GetObjectText).
- Si se solicita una propiedad de una matriz insertada de objetos, se trata como una propiedad con un valor de matriz. Por ejemplo: %MyEvents.TargetInstance.DriverLetter% podría producir '("C:","D:")' si MyEvents es una matriz de eventos de modificación de instancias insertados.
Literales de cadena
Cualquier elemento dentro de un par de comillas se considera un literal de cadena y no se reemplazará.
En el ejemplo siguiente se muestra la cadena que ve el compilador para "CPU utilization is %CPUUtilization%".
CPU utilization is %CPUUtilization%
Esta cadena genera la salida siguiente.
CPU utilization is 90
Por otro lado, el compilador ve la cadena "CPU utilization is \"%CPUUtilization%\"" como se indica a continuación.
CPU utilization is "%CPUUtilization%"
Esta cadena genera la salida siguiente, sin sustitución de variables.
CPU utilization is "%CPUUtilization%"
Temas relacionados