描述將針對目前屬性執行的驗證類型。
語法
HRESULT get_ValidationType(
[out,
retval,
string] BSTR* pbstrValidationType
);
參數
pbstrValidationType
的指標 BSTR ，表示驗證類型。 有效值為 “applicationPath”、“applicationPoolName”、“integerRange”、“nonEmptyString”、“siteName”、“timeSpanRange”、“requireTrimmedString” 和 “virtualDirectoryPath”。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
備註
剖析 XML 時以及 API 呼叫設定組態系統中的值時，就會執行屬性驗證。
下表提供可用的驗證類型。
| 驗證類型 | Description |
|---|---|
| applicationPoolName | 如果屬性值包含下列任何一個字元，驗證將會失敗： |<>&\“/[]+=;：，？*@如果屬性值包含其中一個受限制的字元，下列範例將會導致驗證失敗。 validationType="applicationPoolName"validationParameter="" |
| integerRange | 語法： <minimum>,<maximum>[,exclude]如果屬性值設定為超出指定範圍的值，驗證將會失敗。 如果 屬性設定為小於 1 或大於 10 的值，下列範例將會導致驗證失敗。 validationType="integerRange"validationParameter="1,10,exclude" |
| nonEmptyString | 如果屬性值設定為空字串，驗證將會失敗。 如果屬性值設定為空字串，下列範例將會導致驗證失敗。 validationType="nonEmptyString"validationParameter="" |
| siteName | 如果屬性值包含下列任一字元，驗證將會失敗： /\.?如果屬性值包含其中一個受限制的字元，下列範例將會導致驗證失敗。 validationType="siteName"validationParameter="" |
| timeSpanRange | 語法： <minimum>,<maximum>,<granularity>[,exclude]如果屬性值設定為超出指定範圍的值，驗證將會失敗。 <granularity>值為 60 表示時間範圍代表秒，而值為 1 表示時間範圍代表分鐘。如果 屬性設定為小於 1 或大於 2592000 的值，下列範例將會導致驗證失敗。 validationType="timeSpanRange"validationParameter="1,2592000,60" |
| requireTrimmedString | 如果在開始或結束屬性值找到空格符，驗證將會失敗。 如果屬性值在值的開頭或結尾包含空格符，下列範例將會導致驗證失敗。 validationType="requireTrimmedString"validationParameter="" |
規格需求
| 類型 | Description |
|---|---|
| 用戶端 | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| 標頭 | Ahadmin.h |
另請參閱
IAppHostPropertySchema 介面
IAppHostPropertySchema：：ValidationParameter 屬性