Freigeben über


Festlegen der Variablen

GILT FÜR: Alle API Management-Ebenen

Mit der set-variable-Richtlinie wird eine set-variablevariable deklariert und einem Wert zugewiesen, der über einen Ausdruck oder ein Zeichenfolgenliteral angegeben wird. Wenn der Ausdruck ein Literal enthält, wird die Konvertierung in eine Zeichenfolge durchgeführt, und der Typ des Werts lautet System.String.

Hinweis

Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.

Richtlinienanweisung

<set-variable name="variable name" value="Expression | String literal" />

Attribute

Attribut BESCHREIBUNG Erforderlich
name Der Name der Variablen. Richtlinienausdrücke sind nicht zulässig. Ja
value Der Wert der Variablen. Dies kann ein Ausdruck oder ein Literalwert sein. Richtlinienausdrücke sind zulässig. Ja

Verwendung

Zulässige Typen

Ausdrücke, die in der set-variable-Richtlinie verwendet werden, müssen einen der folgenden einfachen Typen zurückgeben.

  • 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?

Beispiel

Im folgenden Beispiel wird eine set-variable-Richtlinie im Abschnitt für den eingehenden Datenverkehr veranschaulicht. Diese "set-variable"-Richtlinie erstellt die boolesche Kontextvariable isMobile, die auf "true" festgelegt wird, wenn der User-Agent-Anforderungsheader den Text iPad oder iPhone enthält.

<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier: