通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

设置变量

  • 项目

适用于：所有 API 管理层级

set-variable 策略声明set-variable变量，并为其分配通过表达式或字符串文本指定的值。 如果表达式包含文本，则会将其转换为字符串，值的类型将为 System.String。

注意

按照策略声明中提供的顺序设置策略的元素和子元素。 详细了解如何设置或编辑 API 管理策略。

策略语句

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

属性

属性 说明 必需
name 变量的名称。 不允许使用策略表达式。 是
value 变量的值， 可以是表达式或文本值。 允许使用策略表达式。 是

使用情况

允许的类型

在 set-variable 策略中使用的表达式必须返回以下基本类型之一。

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

示例

以下示例演示入站节中的 set-variable 策略。 此设置变量策略创建 isMobile 布尔 context 变量，该变量在 User-Agent 请求标头包含文本 iPad 或 iPhone 的情况下设置为 true。

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

相关内容

有关使用策略的详细信息，请参阅：