DateValidator

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

Die DateValidator-Klasse überprüft, ob ein String, Datum oder Objekt ein zulässiges Datum und ein vorgeschriebenes Format aufweist. Die Benutzer können eine oder zwei Ziffern für Monat, Tag und Jahr eingeben. Standardmäßig sorgt der Validator für die Einhaltung der folgenden Formate:

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- und property-Eigenschaften, um den String anzugeben. Der String kann Ziffern und die Formatierungszeichen enthalten, die in der allowedFormatChars-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 die inputFormat-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 und yearProperty.

MXML-Syntax expanded

MXML-Syntax ausblenden

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"
  />

Beispiele anzeigen

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		actualListeners : Array [schreibgeschützt] Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt.	Validator
		actualTrigger : IEventDispatcher [schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.	Validator
		resourceManager : IResourceManager [schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.	Validator
		subFields : Array Ein Array von Strings mit den Namen der Eigenschaften, die im value-Objekt enthalten sind, das der validate()-Methode übergeben wurde.	Validator

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		DateValidator() 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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialized(document:Object, id:String):void Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird.	Validator
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit.	Validator
		validateAll(validators:Array):Array [statisch] Ruft alle Validators im Array der Validators auf.	Validator
		validateDate(validator:DateValidator, value:Object, baseField:String):Array [statisch] Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.	DateValidator
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		addListenerHandler():void Richtet alle Listener für die gültigen und ungültigen Ereignisse ein, die vom Validator ausgelöst werden.	Validator
		doValidation(value:Object):Array [override] Überschreiben der doValidation()-Methode der Basisklasse für die Überprüfung eines Datums.	DateValidator
		getValueFromSource():Object Gibt das zu überprüfende Objekt zurück.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.	Validator
		isRealValue(value:Object):Boolean Gibt true zurück, wenn der Wert ungleich null ist.	Validator
		removeListenerHandler():void Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.	Validator
		resourcesChanged():void 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

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
invalid	Wird ausgelöst, wenn eine Überprüfung fehlschlägt.	Validator
valid	Wird ausgelöst, wenn eine Überprüfung erfolgreich ist.	Validator

Geschützte Konstanten

Vererbte geschützte Konstanten ausblenden

Vererbte geschützte Konstanten anzeigen

	Konstante		Definiert von

Eigenschaftendetails

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

Konstruktordetails

()

Konstruktor

public function DateValidator()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

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.

Rückgabewerte

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“.

Rückgabewerte

Array — Ein Array von ValidationResult-Objekten mit einem validationResult-Objekt für jedes vom Validator geprüfte Feld.

Verwandte API-Elemente

mx.validators.ValidationResult

Beispiele Verwendung dieses Beispiels

DateValidatorExample.mxml

<?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>

Rechtliche Hinweise | Onlinedatenschutzerklärung

DateValidator - AS3 Flex

Klassen x

allowedFormatChars

dayListener

dayProperty

daySource

formatError

inputFormat

invalidCharError

monthListener

monthProperty

monthSource

validateAsString

wrongDayError

wrongLengthError

wrongMonthError

wrongYearError

yearListener

yearProperty

yearSource

DateValidator

doValidation

validateDate