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.
value Valore della variabile. Può essere un'espressione o un valore letterale. Le espressioni di criteri sono consentite.

Utilizzo

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"))" />

Per ulteriori informazioni sull'utilizzo dei criteri, vedere: