Ange variabel
GÄLLER FÖR: Alla API Management-nivåer
Principen set-variable
deklarerar en kontextvariabel och tilldelar den ett värde som anges via ett uttryck eller en strängliteral. Om uttrycket innehåller en literal konverteras det till en sträng och värdets typ blir System.String
.
Kommentar
Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.
Principuttryck
<set-variable name="variable name" value="Expression | String literal" />
Attribut
Attribut | beskrivning | Obligatoriskt |
---|---|---|
name | Namnet på variabeln. Principuttryck tillåts inte. | Ja |
värde | Variabelns värde. Det kan vara ett uttryck eller ett literalvärde. Principuttryck tillåts. | Ja |
Användning
- Principavsnitt: inkommande, utgående, serverdel, on-error
- Principomfattningar: global, arbetsyta, produkt, API, åtgärd
- Gatewayer: klassisk, v2, förbrukning, lokalt installerad, arbetsyta
Tillåtna typer
Uttryck som används i set-variable
principen måste returnera någon av följande grundläggande typer.
- 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?
Exempel
I följande exempel visas en set-variable
princip i avsnittet inkommande trafik. Den här variabelprincipen skapar en isMobile
boolesk kontextvariabel som är inställd på true om User-Agent
begärandehuvudet innehåller texten iPad
eller iPhone
.
<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />
Relaterade principer
Relaterat innehåll
Mer information om hur du arbetar med principer finns i:
- Självstudie: Transformera och skydda ditt API
- Principreferens för en fullständig lista över principinstruktioner och deras inställningar
- Principuttryck
- Ange eller redigera principer
- Återanvända principkonfigurationer
- Lagringsplats för principfragment
- Skapa principer med Microsoft Copilot i Azure