基验证控件属性

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

下表中列出的属性适用于所有验证控件。

属性

ControlToValidate

验证控件将计算的输入控件的编程 ID。 如果此为非法 ID,则引发异常。

Display

指定的验证控件的显示行为。 此属性可以为下列值之一:

None - 验证控件从不内联显示。 如果希望仅在 ValidationSummary 控件中显示错误信息,则使用此选项。

Static - 如果验证失败,验证控件显示错误信息。 即使输入控件通过了验证,也在网页中为每个错误信息分配空间。 当验证控件显示其错误信息时,页面布局不变。 由于页面布局是静态的,同一输入控件的多个验证控件必须占据页上的不同物理位置。

Dynamic - 如果验证失败,验证控件显示错误信息。 当验证失败时,在页上动态分配错误信息的空间。 这允许多个验证控件共享页面上的同一个物理位置。

NoteNote
由于验证控件的空间是动态创建的,因此页面的物理布局会发生变化。为了防止页面布局在验证控件变得可见时发生更改,必须调整包含验证控件的 HTML 元素的大小,使其大得足以容纳验证控件的最大大小。

EnableClientScript

指示是否启用客户端验证。 通过将 EnableClientScript 属性设置为 false,可在支持此功能的浏览器上禁用客户端验证。

Enabled

指示是否启用验证控件。 通过将该属性设置为 false 可以阻止验证控件验证输入控件。

ErrorMessage

当验证失败时在 ValidationSummary 控件中显示的错误信息。 如果未设置验证控件的 Text 属性,则验证失败时,验证控件中仍显示此文本。 ErrorMessage 属性通常用于为验证控件和 ValidationSummary 控件提供各种消息。

NoteNote
此属性不会将特殊字符转换为 HTML 实体。例如,小于号字符 (<) 不转换为 &lt;。这允许将 HTML 元素(如 <img> 元素)嵌入到该属性的值中。

ForeColor

指定当验证失败时用于显示内联消息的颜色。

IsValid

指示 ControlToValidate 属性所指定的输入控件是否被确定为有效。

SetFocusOnError

指定验证失败时焦点是否被设置为 ControlToValidate 属性所指定的控件。

Text

此属性设置后,验证失败时会在验证控件中显示此消息。 如果未设置此属性,则在该控件中显示 ErrorMessage 属性中指定的文本。

ValidationGroup

指定此验证控件所属的验证组的名称。

请参见

参考

BaseValidator

其他资源

验证服务器控件语法