提供当前属性的属性验证参数信息。
语法
HRESULT get_ValidationParameter(
[out,
retval,
string] BSTR* pbstrValidationParameter
);
parameters
pbstrValidationParameter
指向 BSTR 包含验证参数的 的指针。
返回值
HRESULT。 可能的值包括(但并不限于)下表中的项。
| 值 | 说明 |
|---|---|
| S_OK | 指示操作成功。 |
备注
当分析 XML 时,当 API 调用以在配置系统中设置值时,将执行属性验证。
下表提供了可用的验证类型。
| 验证类型 | 说明 |
|---|---|
| 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>指示在 和 <maximum>之间<minimum>允许的增量。如果属性设置为小于 1、大于 2592000 的值,并且不是范围内 60 的增量,则以下示例将导致验证失败。 validationType="timeSpanRange"validationParameter="1,2592000,60" |
| requireTrimmedString | 如果在属性值的开头或末尾找到空格,验证将失败。 如果属性值在值的开头或末尾包含空格,则以下示例将导致验证失败。 validationType="requireTrimmedString"validationParameter="" |
要求
| 类型 | 说明 |
|---|---|
| 客户端 | - 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 |
| Header | Ahadmin.h |
另请参阅
IAppHostPropertySchema 接口
IAppHostPropertySchema::ValidationType 属性