包mx.validators
类public class DateValidator
继承DateValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

DateValidator 类用于验证字符串、日期或对象是否包含合适的日期以及是否符合指定的格式。用户可以为月、日和年输入一位或两位数字。默认情况下，验证程序可确保以下格式：

您可以按两种方式在 DateValidator 类中指定日期：

MXML 语法expanded隐藏 MXML 语法

The <mx:DateValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DateValidator 
    allowedFormatChars="/\-. " 
    dayListener="Object specified by daySource"
    dayProperty="No default"
    daySource="No default"
    formatError= "Configuration error: Incorrect formatting string." 
    inputFormat="MM/DD/YYYY" 
    invalidCharError="The date contains invalid characters."
    monthListener="Object specified by monthSource"
    monthProperty="No default"
    monthSource="No default"
    validateAsString="true|false"
    wrongDayError="Enter a valid day for the month."
    wrongLengthError="Type the date in the format inputFormat." 
    wrongMonthError="Enter a month between 1 and 12."
    wrongYearError="Enter a year between 0 and 9999."
    yearListener="Object specified by yearSource"
    yearProperty="No default"
    yearSource="No default"
  />

查看示例


公共属性
 属性定义方
  allowedFormatChars : String
允许用于分隔月、日和年值的格式化字符集。
DateValidator
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  dayListener : IValidatorListener
侦听日子字段验证结果的组件。
DateValidator
  dayProperty : String
要验证的日属性的名称。
DateValidator
  daySource : Object
包含日字段的值的对象。
DateValidator
 Inheritedenabled : Boolean
将此值设置为 false 将停止验证程序执行验证操作。
Validator
  formatError : String
inputFormat 属性的格式不正确时的错误消息。
DateValidator
  inputFormat : String
用于验证值的日期格式。
DateValidator
  invalidCharError : String
日期中存在无效字符时的错误消息。
DateValidator
 Inheritedlistener : Object
指定验证侦听器。
Validator
  monthListener : IValidatorListener
侦听月子字段验证结果的组件。
DateValidator
  monthProperty : String
要验证的月属性的名称。
DateValidator
  monthSource : Object
包含月字段的值的对象。
DateValidator
 Inheritedproperty : String
一个字符串，用于指定包含要验证的值的 source 对象的属性名称。
Validator
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 Inheritedrequired : Boolean = true
如果为 true，则指定缺少值或空值将导致验证错误。
Validator
 InheritedrequiredFieldError : String
缺少值和 required 属性为 true 时的错误消息。
Validator
 Inheritedsource : Object
指定包含要验证的属性的对象。
Validator
 Inheritedtrigger : IEventDispatcher
指定生成触发验证程序的组件。
Validator
 InheritedtriggerEvent : String
指定触发验证的事件。
Validator
  validateAsString : Object
确定验证值的方式。
DateValidator
  wrongDayError : String
日无效时的错误消息。
DateValidator
  wrongLengthError : String
日期的长度不符合 inputFormat 属性时的错误消息。
DateValidator
  wrongMonthError : String
月无效时的错误消息。
DateValidator
  wrongYearError : String
年无效时的错误消息。
DateValidator
  yearListener : IValidatorListener
侦听年子字段验证结果的组件。
DateValidator
  yearProperty : String
要验证的年属性的名称。
DateValidator
  yearSource : Object
包含年字段的值的对象。
DateValidator
受保护的属性
 属性定义方
 InheritedactualListeners : Array
[只读 (read-only)] 包含侦听器对象（如果有）的数组或源对象。
Validator
 InheritedactualTrigger : IEventDispatcher
[只读 (read-only)] 包含触发器对象（如果有）或源对象。
Validator
 InheritedresourceManager : IResourceManager
[只读 (read-only)] 引用管理所有应用程序本地化资源的对象。
Validator
 InheritedsubFields : Array
一个字符串数组，其中包含传递到 validate() 方法的 value 对象中所含属性的名称。
Validator
公共方法
 方法定义方
  
DateValidator()
构造函数。
DateValidator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
initialized(document:Object, id:String):void
如果 Validator 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。
Validator
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
执行验证并（可选）将结果通知给侦听器。
Validator
 Inherited
validateAll(validators:Array):Array
[静态] 调用验证程序数组中的所有验证程序。
Validator
  
validateDate(validator:DateValidator, value:Object, baseField:String):Array
[静态] 用于从自定义验证函数内调用验证程序的方便方法。
DateValidator
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
 Inherited
addListenerHandler():void
为从验证程序调度的有效和无效事件设置所有侦听器。
Validator
  
doValidation(value:Object):Array
覆盖基类 doValidation() 方法以验证日期。
DateValidator
 Inherited
getValueFromSource():Object
返回要验证的对象。
Validator
 Inherited
handleResults(errorResults:Array):ValidationResultEvent
从错误结果数组返回 ValidationResultEvent。
Validator
 Inherited
isRealValue(value:Object):Boolean
如果值不为 null，则返回 true。
Validator
 Inherited
removeListenerHandler():void
断开从验证程序调度的有效和无效事件的所有侦听器的连接。
Validator
 Inherited
resourcesChanged():void
构造 Validator 后，每当 ResourceManager 又调度一个“change”事件以指示已通过某种方式更改了本地化资源时，将会调用此方法。
Validator
事件
 事件 摘要 定义方
 Inherited
activate
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited
deactivate
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited
invalid
在验证失败时调度。Validator
 Inherited
valid
在验证成功时调度。Validator
受保护的常量
 常量定义方
 InheritedDECIMAL_DIGITS : String = "0123456789"
[静态] 包含十进制数字 0 到 9 的字符串。
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[静态] 包含大写和小写罗马字母（“A”到“Z”和“a”到“z”）的字符串。
Validator
属性详细信息
allowedFormatChars属性
allowedFormatChars:String  [读写]

允许用于分隔月、日和年值的格式化字符集。

默认值为 "/\-. ".



实现
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String):void
dayListener属性 
dayListener:IValidatorListener  [读写]

侦听日子字段验证结果的组件。如果未进行指定，则使用为 daySource 属性指定的值。



实现
    public function get dayListener():IValidatorListener
    public function set dayListener(value:IValidatorListener):void
dayProperty属性 
public var dayProperty:String

要验证的日属性的名称。此属性为可选项，但如果指定 daySource 属性，则应同时设置此属性。

daySource属性 
daySource:Object  [读写]

包含日字段的值的对象。如果为此属性指定值，则必须同时为 dayProperty 属性指定值。如果设置 source 和 property 属性，请不要使用此属性。



实现
    public function get daySource():Object
    public function set daySource(value:Object):void
formatError属性 
formatError:String  [读写]

inputFormat 属性的格式不正确时的错误消息。

默认值为 "Configuration error: Incorrect formatting string.".



实现
    public function get formatError():String
    public function set formatError(value:String):void
inputFormat属性 
inputFormat:String  [读写]

用于验证值的日期格式。“MM”表示月，“DD”表示日，“YYYY”表示年。此字符串区分大小写。

默认值为 "MM/DD/YYYY".



实现
    public function get inputFormat():String
    public function set inputFormat(value:String):void
invalidCharError属性 
invalidCharError:String  [读写]

日期中存在无效字符时的错误消息。

默认值为 "Invalid characters in your date.".



实现
    public function get invalidCharError():String
    public function set invalidCharError(value:String):void
monthListener属性 
monthListener:IValidatorListener  [读写]

侦听月子字段验证结果的组件。如果未进行指定，则使用为 monthSource 属性指定的值。



实现
    public function get monthListener():IValidatorListener
    public function set monthListener(value:IValidatorListener):void
monthProperty属性 
public var monthProperty:String

要验证的月属性的名称。此属性为可选项，但如果指定 monthSource 属性，则应同时设置此属性。

monthSource属性 
monthSource:Object  [读写]

包含月字段的值的对象。如果为此属性指定值，则必须同时为 monthProperty 属性指定值。如果设置 source 和 property 属性，请不要使用此属性。



实现
    public function get monthSource():Object
    public function set monthSource(value:Object):void
validateAsString属性 
validateAsString:Object  [读写]

确定验证值的方式。如果设置为 true，除非值具有 month、day 或 year 属性，否则验证程序将值作为字符串进行评估。如果为 false，则验证程序将值作为日期对象进行评估。

默认值为 true.



实现
    public function get validateAsString():Object
    public function set validateAsString(value:Object):void
wrongDayError属性 
wrongDayError:String  [读写]

日无效时的错误消息。

默认值为 "Enter a valid day for the month.".



实现
    public function get wrongDayError():String
    public function set wrongDayError(value:String):void
wrongLengthError属性 
wrongLengthError:String  [读写]

日期的长度不符合 inputFormat 属性时的错误消息。

默认值为 "Type the date in the format inputFormat.".



实现
    public function get wrongLengthError():String
    public function set wrongLengthError(value:String):void
wrongMonthError属性 
wrongMonthError:String  [读写]

月无效时的错误消息。

默认值为 "Enter a month between 1 and 12.".



实现
    public function get wrongMonthError():String
    public function set wrongMonthError(value:String):void
wrongYearError属性 
wrongYearError:String  [读写]

年无效时的错误消息。

默认值为 "Enter a year between 0 and 9999.".



实现
    public function get wrongYearError():String
    public function set wrongYearError(value:String):void
yearListener属性 
yearListener:IValidatorListener  [读写]

侦听年子字段验证结果的组件。如果未进行指定，则使用为 yearSource 属性指定的值。



实现
    public function get yearListener():IValidatorListener
    public function set yearListener(value:IValidatorListener):void
yearProperty属性 
public var yearProperty:String

要验证的年属性的名称。此属性为可选项，但如果指定 yearSource 属性，则应同时设置此属性。

yearSource属性 
yearSource:Object  [读写]

包含年字段的值的对象。如果为此属性指定值，则必须同时为 yearProperty 属性指定值。如果设置 source 和 property 属性，请不要使用此属性。



实现
    public function get yearSource():Object
    public function set yearSource(value:Object):void
构造函数详细信息
DateValidator()构造函数
public function DateValidator()

构造函数。

方法详细信息
doValidation()方法
override protected function doValidation(value:Object):Array

覆盖基类 doValidation() 方法以验证日期。

不要直接调用此方法；Flex 会在执行验证的过程中调用它。如果创建自定义 validator 类，则必须实现此方法。

参数

value:Object — 要验证的字符串或对象。

返回
Array — ValidationResult 对象的数组，验证程序检查的每个字段都有一个 ValidationResult 对象。
validateDate()方法 
public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array

用于从自定义验证函数内调用验证程序的方便方法。每个标准 Flex 验证程序都有一个类似的方便方法。

参数

validator:DateValidator — DateValidator 实例。
 
value:Object — 要验证的字段。
 
baseField:String — 在值参数中指定的子字段的文本表示形式。例如，如果 value 参数指定 value.date，则 baseField 值为“date”。

返回
Array — ValidationResult 对象的数组，验证程序检查的每个字段都有一个 ValidationResult 对象。

另请参见

mx.validators.ValidationResult
示例 如何使用示例
DateValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateValidator. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        import mx.controls.Alert;
    </mx:Script>

    <mx:Model id="CheckModel">
        <dateInfo>
            <DOB>{dob.text}</DOB>
        </dateInfo>
    </mx:Model>

    <mx:DateValidator source="{dob}" property="text" allowedFormatChars="/" 
        trigger="{myButton}" triggerEvent="click" 
        valid="Alert.show('Validation Succeeded!');"/>

    <mx:Panel title="DateValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form>
            <mx:FormItem label="Enter date of birth (mm/dd/yyyy): ">
                <mx:TextInput id="dob" width="100%"/>
            </mx:FormItem>

            <mx:FormItem >
                <mx:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>

    </mx:Panel>
</mx:Application>



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00