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

Microsoft.Compute.UserNameTextBox UI 元素

一个具有针对 Windows 和 Linux 用户名的内置验证的文本框控件。

UI 示例

架构

{
  "name": "element1",
  "type": "Microsoft.Compute.UserNameTextBox",
  "label": "User name",
  "defaultValue": "",
  "toolTip": "",
  "constraints": {
    "required": true,
    "regex": "^[a-z0-9A-Z]{1,30}$",
    "validationMessage": "Only alphanumeric characters are allowed, and the value must be 1-30 characters long."
  },
  "osPlatform": "Windows",
  "visible": true
}

示例输出

"Example name"

备注

• 如果 设置为 true，则文本框必须包含值才能成功通过验证 。 默认值为 true。
• 必须指定 osPlatform，它可以是 Windows 或 Linux。
• constraints.regex 是一个 JavaScript 正则表达式模式。 如果指定，则文本框的值必须与模式完全匹配才能成功通过验证。 默认值为 null。
• constraints.validationMessage 是当文本框的值未通过 constraints.regex 指定的验证时会显示的一个字符串。 如果未指定，则会使用文本框的内置验证消息。 默认值为 null。
• 此元素具有基于为 osPlatform 指定的值的内置验证。 内置验证可用于自定义正则表达式。 如果指定了 constraints.regex 的值，则会同时触发内置验证和自定义验证。

后续步骤

• 有关创建 UI 定义的简介，请参阅 CreateUiDefinition 入门。
• 有关 UI 元素中的公用属性的说明，请参阅 CreateUiDefinition 元素。