Imposta variabile
SI APPLICA A: Tutti i livelli di Gestione API
Il criterio set-variable dichiara una variabile di contesto e assegna a essa un valore specificato tramite un'espressione o un valore letterale di stringa. Se l'espressione contiene un valore letterale sarà convertita in una stringa e il tipo del valore sarà System.String.
Nota
Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.
Istruzione del criterio
<set-variable name="variable name" value="Expression | String literal" />
Attributi
| Attributo | Descrizione | Richiesto |
|---|---|---|
| name | Nome della variabile. Le espressioni di criteri non sono consentite. | Sì |
| value | Valore della variabile. Può essere un'espressione o un valore letterale. Le espressioni di criteri sono consentite. | Sì |
Utilizzo
- Sezioni del criterio: inbound, outbound, backend, on-error
- Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
- Gateway: classico, v2, consumo, self-hosted, area di lavoro
Tipi consentiti
Le espressioni usate nel criterio set-variable devono restituire uno dei seguenti tipi di base.
- 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?
Esempio
L'esempio seguente illustra un criterio set-variable nella sezione in ingresso. Il criterio di impostazione della variabile crea isMobile, una variabile di contesto booleana, che è impostata su true se l'intestazione della richiesta User-Agent contiene il testo iPad o iPhone.
<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />
Criteri correlati
Contenuto correlato
Per ulteriori informazioni sull'utilizzo dei criteri, vedere:
- Esercitazione: trasformare e proteggere l'API
- Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
- Espressioni di criteri
- Impostare o modificare criteri
- Riutilizzare le configurazioni dei criteri
- Repository dei frammenti di criteri
- Creare criteri usando Microsoft Copilot in Azure