EmailValidator

Paket	mx.validators
Klasse	public class EmailValidator
Vererbung	EmailValidator Validator EventDispatcher Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die EmailValidator-Klasse überprüft, dass ein String ein einzelnes @-Zeichen sowie einen Punkt im Domänennamen aufweist und ob das Domänensuffix der höchsten Ebene zwei, drei, vier oder sechs Zeichen enthält. IP-Domänennamen sind gültig, wenn sie in eckigen Klammern stehen. Der Validator überprüft nicht, ob die Domäne und der Benutzername wirklich existieren.

Sie können IP-Domänennamen verwenden, wenn sie in eckigen Klammern stehen, beispielsweise meinname@[206.132.22.1]. Sie können einzelne IP-Nummern von 0 bis 255 verwenden.

MXML-Syntax expanded

MXML-Syntax ausblenden

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

  <mx:EmailValidator 
    invalidCharError="Your e-mail address contains invalid characters."
    invalidDomainError= "The domain in your e-mail address is incorrectly formatted." 
    invalidIPDomainError="The IP domain in your e-mail address is incorrectly formatted." 
    invalidPeriodsInDomainError="The domain in your e-mail address has consecutive periods." 
    missingAtSignError="An at sign (&64;) is missing in your e-mail address."
    missingPeriodInDomainError="The domain in your e-mail address is missing a period." 
    missingUsernameError="The username in your e-mail address is missing." 
    tooManyAtSignsError="Your e-mail address contains too many &64; characters."
  />

Beispiele anzeigen

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		enabled : Boolean Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt.	Validator
		invalidCharError : String Fehlermeldung, wenn die E-Mail-Adresse ungültige Zeichen enthält.	EmailValidator
		invalidDomainError : String Fehlermeldung, wenn das Suffix (die Domäne der höchsten Ebene) nicht 2, 3, 4 oder 6 Zeichen lang ist.	EmailValidator
		invalidIPDomainError : String Fehlermeldung, wenn die IP-Domäne ungültig ist.	EmailValidator
		invalidPeriodsInDomainError : String Fehlermeldung, wenn die Domäne eine Sequenz von Punkten enthält.	EmailValidator
		listener : Object Gibt den Überprüfungs-Listener an.	Validator
		missingAtSignError : String Fehlermeldung, wenn das @-Zeichen in der E-Mail-Adresse fehlt.	EmailValidator
		missingPeriodInDomainError : String Fehlermeldung, wenn die Domäne keinen Punkt enthält.	EmailValidator
		missingUsernameError : String Fehlermeldung, wenn kein Benutzername vorhanden ist.	EmailValidator
		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
		tooManyAtSignsError : String Fehlermeldung, wenn die E-Mail-Adresse mehr als ein @-Zeichen enthält.	EmailValidator
		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

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
		EmailValidator() Konstruktor.	EmailValidator
		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
		validateEmail(validator:EmailValidator, value:Object, baseField:String):Array [statisch] Vereinfachungsmethode zum Aufrufen eines Validators aus einer benutzerdefinierten Überprüfungsfunktion.	EmailValidator
		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 einer E-Mail-Adresse.	EmailValidator
		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

invalidCharError

Eigenschaft

invalidCharError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die E-Mail-Adresse ungültige Zeichen enthält.

Der Standardwert ist "Your e-mail address contains invalid characters.".

Implementierung
public function get invalidCharError():String
public function set invalidCharError(value:String):void

invalidDomainError

Eigenschaft

invalidDomainError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das Suffix (die Domäne der höchsten Ebene) nicht 2, 3, 4 oder 6 Zeichen lang ist.

Der Standardwert ist "The domain in your e-mail address is incorrectly formatted.".

Implementierung
public function get invalidDomainError():String
public function set invalidDomainError(value:String):void

invalidIPDomainError

Eigenschaft

invalidIPDomainError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die IP-Domäne ungültig ist. Die IP-Domäne muss in eckigen Klammern stehen.

Der Standardwert ist "The IP domain in your e-mail address is incorrectly formatted.".

Implementierung
public function get invalidIPDomainError():String
public function set invalidIPDomainError(value:String):void

invalidPeriodsInDomainError

Eigenschaft

invalidPeriodsInDomainError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die Domäne eine Sequenz von Punkten enthält.

Der Standardwert ist "The domain in your e-mail address has continous periods.".

Implementierung
public function get invalidPeriodsInDomainError():String
public function set invalidPeriodsInDomainError(value:String):void

missingAtSignError

Eigenschaft

missingAtSignError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das @-Zeichen in der E-Mail-Adresse fehlt.

Der Standardwert ist "An at sign (&64;) is missing in your e-mail address.".

Implementierung
public function get missingAtSignError():String
public function set missingAtSignError(value:String):void

missingPeriodInDomainError

Eigenschaft

missingPeriodInDomainError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die Domäne keinen Punkt enthält.

Der Standardwert ist "The domain in your e-mail address is missing a period.".

Implementierung
public function get missingPeriodInDomainError():String
public function set missingPeriodInDomainError(value:String):void

missingUsernameError

Eigenschaft

missingUsernameError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn kein Benutzername vorhanden ist.

Der Standardwert ist "The username in your e-mail address is missing.".

Implementierung
public function get missingUsernameError():String
public function set missingUsernameError(value:String):void

tooManyAtSignsError

Eigenschaft

tooManyAtSignsError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die E-Mail-Adresse mehr als ein @-Zeichen enthält. Diese Eigenschaft ist optional.

Der Standardwert ist "Your e-mail address contains too many &64; characters.".

Implementierung
public function get tooManyAtSignsError():String
public function set tooManyAtSignsError(value:String):void

Konstruktordetails

()

Konstruktor

public function EmailValidator()

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 einer E-Mail-Adresse.

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.

validateEmail

()

Methode

public static function validateEmail(validator:EmailValidator, 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:EmailValidator` — Die EmailValidator-Instanz.

	`value:Object` — Ein zu überprüfendes Feld.

	`baseField:String` — Textdarstellung des im Wertparameter angegebenen Unterfelds. Wenn zum Beispiel im `value`-Parameter value.email angegeben ist, ist der `baseField`-Wert „email“.

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

EmailValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the EmailValidator. -->
<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>
        <mx:EmailValidator source="{email}" property="text" 
                trigger="{myButton}" triggerEvent="click"
                valid="Alert.show('Validation Succeeded!');"/>
    </fx:Declarations>

    <s:Panel title="EmailValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter an e-mail address: ">
                <s:TextInput id="email" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

EmailValidator - AS3 Flex

Klassen x

invalidCharError

invalidDomainError

invalidIPDomainError

invalidPeriodsInDomainError

missingAtSignError

missingPeriodInDomainError

missingUsernameError

tooManyAtSignsError

EmailValidator

doValidation

validateEmail