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"

備註

• 如果 constraints.required 設為 true，則文字輸入框必須有可成功驗證的值。 預設值是 true。
• 必須指定 osPlatform，且可以是 Windows 或 Linux。
• constraints.regex 是 JavaScript 規則運算式模式。 如果指定，文字方塊的值就必須符合模式，才能順利通過驗證。 預設值是 null。
• 當文字方塊的值無法通過 constraints.regex 驗證時，就會顯示 constraints.validationMessage 字串。 如果未指定，則會使用文字方塊的內建的驗證訊息。 預設值是 null。
• 這個元素具有根據 osPlatform 指定值的內建驗證。 內建驗證可以搭配自定義正則表達式使用。 如果指定了 constraints.regex 值，就會觸發內建和自訂驗證。

下一步

• 如需建立 UI 定義的簡介，請參閱開始使用 CreateUiDefinition。
• 如需 UI 元素中通用屬性的說明，請參閱 CreateUiDefinition 元素。