Establecer la variable
SE APLICA A: todos los niveles de API Management
La directiva set-variable declara una variable de set-variable y le asigna un valor que se especifica mediante una expresión o un literal de cadena. Si la expresión contiene un valor literal, se convertirá en una cadena y el tipo del valor será System.String.
Nota:
Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.
Instrucción de la directiva
<set-variable name="variable name" value="Expression | String literal" />
Atributos
| Atributo | Descripción | Obligatorio |
|---|---|---|
| name | El nombre de la variable. No se permiten expresiones de directiva. | Sí |
| value | Valor de la variable. Puede ser una expresión o un valor literal. Se permiten expresiones de directiva. | Sí |
Uso
- Secciones de directiva: entrante, saliente, back-end, on-error
- Ámbitos de la directiva: global, área de trabajo, producto, API, operación
- Puertas de enlace: clásica, v2, consumo, autohospedado y área de trabajo
Tipos permitidos
Las expresiones usadas en la directiva set-variable deben devolver uno de los siguientes tipos básicos.
- System.Boolean
- System.SByte
- System.Byte
- System.UInt16
- System.UInt32
- System.UInt64
- System.Int16
- System.Int32
- System.Int64
- System.Decimal
- System.Single
- System.Double
- System.Guid
- System.String
- System.Char
- System.DateTime
- System.TimeSpan
- System.Byte?
- System.UInt16?
- System.UInt32?
- System.UInt64?
- System.Int16?
- System.Int32?
- System.Int64?
- System.Decimal?
- System.Single?
- System.Double?
- System.Guid?
- System.String?
- System.Char?
- System.DateTime?
Ejemplo
En el ejemplo siguiente se muestra una directiva set-variable en la sección entrante. Esta variable de directiva establecida crea una variable de contexto booleana isMobile que se establece en true si el encabezado de la solicitud User-Agent contiene el texto iPad o iPhone.
<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />
Directivas relacionadas
Contenido relacionado
Para más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
- Expresiones de directiva
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Kit de herramientas de directivas de Azure API Management
- Creación de directivas mediante Microsoft Copilot en Azure