Paket | mx.validators |
Klasse | public class DateValidator |
Vererbung | DateValidator Validator EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
- Der Monat ist eine Zahl von 1 bis 12 (oder 0-11 für
Date
-Objekte) - Der Tag ist eine Zahl von 1 bis 31
- Das Jahr ist eine Zahl
Sie haben für die Angabe des Datums in der DateValidator-Klasse zwei Möglichkeiten:
- Einzelner String mit dem Datum - Verwenden Sie die
source
- undproperty
-Eigenschaften, um den String anzugeben. Der String kann Ziffern und die Formatierungszeichen enthalten, die in derallowedFormatChars
-Eigenschaft angegeben sind; einschließlich der Zeichen „/\-. “. Standardmäßig ist das Eingabeformat des Datums in einem Stringfeld „MM/TT/JJJ“, wobei „MM“, der Monat ist, „TT“ der Tag und „JJ“ das Jahr Sie können dieinputFormat
-Eigenschaft verwenden, um ein anderes Format anzugeben. -
Date-Objekt.
- Objekt oder mehrere Felder, die Tag, Monat und Jahr enthalten. Verwenden Sie alle nachstehenden Parameter für Tages-, Monats- und Jahresangaben:
daySource
,dayProperty
,monthSource
,monthProperty
,yearSource
undyearProperty
.
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" />
Eigenschaft | Definiert von | ||
---|---|---|---|
allowedFormatChars : String
Der Formatierungszeichensatz, der zum Trennen von Monats-, Tages- und Jahreswerten zulässig ist. | DateValidator | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
dayListener : IValidatorListener
Die Komponente, die das Überprüfungsergebnis für das Tagesunterfeld abwartet. | DateValidator | ||
dayProperty : String
Name der zu überprüfenden Tageseigenschaft. | DateValidator | ||
daySource : Object
Objekt, das den Wert des Tagesfelds enthält. | DateValidator | ||
enabled : Boolean
Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt. | Validator | ||
formatError : String
Fehlermeldung, wenn das Format der inputFormat-Eigenschaft falsch ist. | DateValidator | ||
inputFormat : String
Das Datumsformat für die Überprüfung des Werts. | DateValidator | ||
invalidCharError : String
Fehlermeldung, wenn das Datum ungültige Zeichen enthält. | DateValidator | ||
listener : Object
Gibt den Überprüfungs-Listener an. | Validator | ||
monthListener : IValidatorListener
Die Komponente, die das Überprüfungsergebnis für das Monatsunterfeld abwartet. | DateValidator | ||
monthProperty : String
Name der zu überprüfenden Monatseigenschaft. | DateValidator | ||
monthSource : Object
Objekt, das den Wert des Monatsfelds enthält. | DateValidator | ||
property : String
Ein String, der den Namen der Eigenschaft des Quellobjekts angibt, das den zu prüfenden Wert enthält. | Validator | ||
required : Boolean = true
Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt. | Validator | ||
requiredFieldError : String
Fehlermeldung, wenn ein Wert fehlt und die erforderliche Eigenschaft true ist. | Validator | ||
source : Object
Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist. | Validator | ||
trigger : IEventDispatcher
Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst. | Validator | ||
triggerEvent : String
Gibt das Ereignis an, das die Überprüfung auslöst. | Validator | ||
validateAsString : Object
Bestimmt, wie der Wert überprüft wird. | DateValidator | ||
wrongDayError : String
Fehlermeldung, wenn der Tag ungültig ist. | DateValidator | ||
wrongLengthError : String
Fehlermeldung, wenn die Länge des Datums nicht mit der inputFormat-Eigenschaft übereinstimmt. | DateValidator | ||
wrongMonthError : String
Fehlermeldung, wenn der Monat ungültig ist. | DateValidator | ||
wrongYearError : String
Fehlermeldung, wenn das Jahr ungültig ist. | DateValidator | ||
yearListener : IValidatorListener
Die Komponente, die das Überprüfungsergebnis für das Jahresunterfeld abwartet. | DateValidator | ||
yearProperty : String
Name der zu überprüfenden Jahreseigenschaft. | DateValidator | ||
yearSource : Object
Objekt, das den Wert des Jahresfelds enthält. | DateValidator |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | DateValidator | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird. | Validator | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit. | Validator | ||
[statisch]
Ruft alle Validators im Array der Validators auf. | Validator | ||
[statisch]
Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion. | DateValidator | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Methode | Definiert von | ||
---|---|---|---|
Richtet alle Listener für die gültigen und ungültigen Ereignisse ein, die vom Validator ausgelöst werden. | Validator | ||
[override]
Überschreiben der doValidation()-Methode der Basisklasse für die Überprüfung eines Datums. | DateValidator | ||
Gibt das zu überprüfende Objekt zurück. | Validator | ||
Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück. | Validator | ||
Gibt true zurück, wenn der Wert ungleich null ist. | Validator | ||
Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden. | Validator | ||
Diese Methode wird aufgerufen, wenn ein Validator erzeugt wird und jedes Mal, wenn ein ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass die lokalisierten Ressourcen eine Änderung erfahren haben. | Validator |
allowedFormatChars | Eigenschaft |
allowedFormatChars:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Der Formatierungszeichensatz, der zum Trennen von Monats-, Tages- und Jahreswerten zulässig ist.
Der Standardwert ist "/\-. ".
Implementierung
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void
dayListener | Eigenschaft |
dayListener:IValidatorListener
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Komponente, die das Überprüfungsergebnis für das Tagesunterfeld abwartet. Wenn nichts angegeben ist, verwenden Sie den Wert, der für die daySource
-Eigenschaft angegeben ist.
Implementierung
public function get dayListener():IValidatorListener
public function set dayListener(value:IValidatorListener):void
dayProperty | Eigenschaft |
public var dayProperty:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Name der zu überprüfenden Tageseigenschaft. Diese Eigenschaft ist optional, aber wenn Sie die daySource
-Eigenschaft angeben, müssen Sie auch diese Eigenschaft einstellen.
daySource | Eigenschaft |
daySource:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Objekt, das den Wert des Tagesfelds enthält. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie auch einen Wert für die dayProperty
-Eigenschaft angeben. Verwenden Sie diese Eigenschaft nicht, wenn Sie die source
- und property
-Eigenschaften setzen.
Implementierung
public function get daySource():Object
public function set daySource(value:Object):void
formatError | Eigenschaft |
formatError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn das Format der inputFormat
-Eigenschaft falsch ist.
Der Standardwert ist "Configuration error: Incorrect formatting string.".
Implementierung
public function get formatError():String
public function set formatError(value:String):void
inputFormat | Eigenschaft |
inputFormat:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Das Datumsformat für die Überprüfung des Werts. „MM“ ist der Monat, „TT“ der Tag und „JJ“ das Jahr. Dieser String unterscheidet zwischen Groß- und Kleinbuchstaben.
Der Standardwert ist "MM/DD/YYYY".
Implementierung
public function get inputFormat():String
public function set inputFormat(value:String):void
invalidCharError | Eigenschaft |
invalidCharError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn das Datum ungültige Zeichen enthält.
Der Standardwert ist "Invalid characters in your date.".
Implementierung
public function get invalidCharError():String
public function set invalidCharError(value:String):void
monthListener | Eigenschaft |
monthListener:IValidatorListener
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Komponente, die das Überprüfungsergebnis für das Monatsunterfeld abwartet. Wenn nichts angegeben ist, verwenden Sie den Wert, der für die monthSource
-Eigenschaft angegeben ist.
Implementierung
public function get monthListener():IValidatorListener
public function set monthListener(value:IValidatorListener):void
monthProperty | Eigenschaft |
public var monthProperty:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Name der zu überprüfenden Monatseigenschaft. Diese Eigenschaft ist optional, aber wenn Sie die monthSource
-Eigenschaft angeben, müssen Sie auch diese Eigenschaft einstellen.
monthSource | Eigenschaft |
monthSource:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Objekt, das den Wert des Monatsfelds enthält. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie auch einen Wert für die monthProperty
-Eigenschaft angeben. Verwenden Sie diese Eigenschaft nicht, wenn Sie die source
- und property
-Eigenschaften setzen.
Implementierung
public function get monthSource():Object
public function set monthSource(value:Object):void
validateAsString | Eigenschaft |
validateAsString:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bestimmt, wie der Wert überprüft wird. Wenn auf true
gesetzt, kontrolliert der Validator den Wert als String, unabhängig davon, ob der Wert eine month
, day
oder year
-Eigenschaft ist. Wenn auf false
gesetzt, kontrolliert der Validator den Wert als Datumsobjekt.
Der Standardwert ist true.
Implementierung
public function get validateAsString():Object
public function set validateAsString(value:Object):void
wrongDayError | Eigenschaft |
wrongDayError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Tag ungültig ist.
Der Standardwert ist "Enter a valid day for the month.".
Implementierung
public function get wrongDayError():String
public function set wrongDayError(value:String):void
wrongLengthError | Eigenschaft |
wrongLengthError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn die Länge des Datums nicht mit der inputFormat
-Eigenschaft übereinstimmt.
Der Standardwert ist "Type the date in the format inputFormat.".
Implementierung
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void
wrongMonthError | Eigenschaft |
wrongMonthError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn der Monat ungültig ist.
Der Standardwert ist "Enter a month between 1 and 12.".
Implementierung
public function get wrongMonthError():String
public function set wrongMonthError(value:String):void
wrongYearError | Eigenschaft |
wrongYearError:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Fehlermeldung, wenn das Jahr ungültig ist.
Der Standardwert ist "Enter a year between 0 and 9999.".
Implementierung
public function get wrongYearError():String
public function set wrongYearError(value:String):void
yearListener | Eigenschaft |
yearListener:IValidatorListener
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Komponente, die das Überprüfungsergebnis für das Jahresunterfeld abwartet. Wenn nichts angegeben ist, verwenden Sie den Wert, der für die yearSource
-Eigenschaft angegeben ist.
Implementierung
public function get yearListener():IValidatorListener
public function set yearListener(value:IValidatorListener):void
yearProperty | Eigenschaft |
public var yearProperty:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Name der zu überprüfenden Jahreseigenschaft. Diese Eigenschaft ist optional, aber wenn Sie die yearSource
-Eigenschaft angeben, müssen Sie auch diese Eigenschaft einstellen.
yearSource | Eigenschaft |
yearSource:Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Objekt, das den Wert des Jahresfelds enthält. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie auch einen Wert für die yearProperty
-Eigenschaft angeben. Verwenden Sie diese Eigenschaft nicht, wenn Sie die source
- und property
-Eigenschaften setzen.
Implementierung
public function get yearSource():Object
public function set yearSource(value:Object):void
DateValidator | () | Konstruktor |
public function DateValidator()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
doValidation | () | Methode |
override protected function doValidation(value:Object):Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Überschreiben der doValidation()
-Methode der Basisklasse für die Überprüfung eines Datums.
Diese Methode wird nicht direkt aufgerufen; Flex ruft sie als Teil einer Überprüfung auf. Wenn Sie eine benutzerdefinierte Validator-Klasse erstellen, müssen Sie diese Methode implementieren.
Parameter
value:Object — Entweder ein String oder ein Objekt zur Überprüfung.
|
Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.
|
validateDate | () | Methode |
public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode.
Parameter
validator:DateValidator — Die DateValidator-Instanz.
| |
value:Object — Ein zu überprüfendes Feld.
| |
baseField:String — Textdarstellung des im Wertparameter angegebenen Unterfelds. Wenn zum Beispiel im value -Parameter value.date angegeben ist, ist der baseField -Wert „date“.
|
Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.
|
Verwandte API-Elemente
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the DateValidator. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> import mx.controls.Alert; </fx:Script> <fx:Declarations> <fx:Model id="CheckModel"> <dateInfo> <DOB>{dob.text}</DOB> </dateInfo> </fx:Model> <mx:DateValidator source="{dob}" property="text" allowedFormatChars="/" trigger="{myButton}" triggerEvent="click" valid="Alert.show('Validation Succeeded!');"/> </fx:Declarations> <s:Panel title="DateValidator Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <mx:Form left="10" right="10" top="10" bottom="10"> <mx:FormItem label="Enter date of birth (mm/dd/yyyy): "> <s:TextInput id="dob" width="100%"/> </mx:FormItem> <mx:FormItem > <s:Button id="myButton" label="Validate" /> </mx:FormItem> </mx:Form> </s:Panel> </s:Application>
Tue Jun 12 2018, 10:04 AM Z