ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.validators 

SocialSecurityValidator  - AS3 Flex

Paketmx.validators
Klassepublic class SocialSecurityValidator
VererbungSocialSecurityValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die SocialSecurityValidator-Klasse überprüft, ob ein String eine gültige deutsche Sozialversicherungsnummer ist. Der Validator überprüft nicht, ob die Sozialversicherungsnummer auch tatsächlich existiert.

MXML-SyntaxexpandedMXML-Syntax ausblenden

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

  <mx:SocialSecurityValidator
    allowedFormatChars=" -"
    invalidCharError="You entered invalid characters in your Social Security number."
    wrongFormatError="The Social Security number must be 9 digits or in the form NNN-NN-NNNN."
    zeroStartError="Invalid Social Security number; the number cannot start with 000."
  />
  

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  allowedFormatChars : String
Gibt den Satz der für die Eingabe zulässige Formatierungszeichen an.
SocialSecurityValidator
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedenabled : Boolean
Wird dieser Wert auf false eingestellt, werden für diesen Validator keine weiteren Überprüfungen mehr ausgeführt.
Validator
  invalidCharError : String
Fehlermeldung, wenn der Wert andere Zeichen als Ziffern und in der allowedFormatChars-Eigenschaft angegebene Formatierungszeichen enthält.
SocialSecurityValidator
 Inheritedlistener : Object
Gibt den Überprüfungs-Listener an.
Validator
 Inheritedproperty : String
Ein String, der den Namen der Eigenschaft des Quellobjekts angibt, das den zu prüfenden Wert enthält.
Validator
 Inheritedrequired : Boolean = true
Wenn true: gibt an, dass ein fehlender oder leerer Wert einen Überprüfungsfehler erzeugt.
Validator
 InheritedrequiredFieldError : String
Fehlermeldung, wenn ein Wert fehlt und die erforderliche Eigenschaft true ist.
Validator
 Inheritedsource : Object
Gibt den Namen des Objekts an, das in der zu überprüfenden Eigenschaft enthalten ist.
Validator
 Inheritedtrigger : IEventDispatcher
Gibt die Komponente an, die das Ereignis generiert, das den Validator auslöst.
Validator
 InheritedtriggerEvent : String
Gibt das Ereignis an, das die Überprüfung auslöst.
Validator
  wrongFormatError : String
Fehlermeldung, wenn der Wert falsch formatiert ist.
SocialSecurityValidator
  zeroStartError : String
Fehlermeldung, wenn der Wert eine ungültige Sozialversicherungsnummer enthält.
SocialSecurityValidator
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedactualListeners : Array
[schreibgeschützt] Enthält ein Array von Listener-Objekten (wenn vorhanden) oder das Quellobjekt.
Validator
 InheritedactualTrigger : IEventDispatcher
[schreibgeschützt] Enthält das Auslöserobjekt (wenn überhaupt) oder das Quellobjekt.
Validator
 InheritedresourceManager : IResourceManager
[schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.
Validator
 InheritedsubFields : 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
 MethodeDefiniert von
  
Konstruktor.
SocialSecurityValidator
 Inherited
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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wird automatisch vom MXML-Compiler aufgerufen, wenn der Validator mithilfe eines MXML-Tags erstellt wird.
Validator
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
Führt eine Überprüfung aus und teilt optional den Listenern das Ergebnis mit.
Validator
 Inherited
validateAll(validators:Array):Array
[statisch] Ruft alle Validators im Array der Validators auf.
Validator
  
[statisch] Vereinfachungsmethode zum Aufrufen eines Validators.
SocialSecurityValidator
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 MethodeDefiniert von
 Inherited
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 einer Sozialversicherungsnummer.
SocialSecurityValidator
 Inherited
Gibt das zu überprüfende Objekt zurück.
Validator
 Inherited
Gibt ein ValidationResultEvent vom Array der Fehlerergebnisse zurück.
Validator
 Inherited
Gibt true zurück, wenn der Wert ungleich null ist.
Validator
 Inherited
Trennt alle Listener für die gültigen und ungültigen Ereignisse, die vom Validator ausgelöst werden.
Validator
 Inherited
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
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn eine Überprüfung fehlschlägt.Validator
 InheritedWird ausgelöst, wenn eine Überprüfung erfolgreich ist.Validator
Eigenschaftendetails

allowedFormatChars

Eigenschaft
allowedFormatChars:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Gibt den Satz der für die Eingabe zulässige Formatierungszeichen an.

Der Standardwert ist "()- .+" // ?????.



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

invalidCharError

Eigenschaft 
invalidCharError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung, wenn der Wert andere Zeichen als Ziffern und in der allowedFormatChars-Eigenschaft angegebene Formatierungszeichen enthält.

Der Standardwert ist "You entered invalid characters in your Social Security number.".



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

wrongFormatError

Eigenschaft 
wrongFormatError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung, wenn der Wert falsch formatiert ist.

Der Standardwert ist "The Social Security number must be 9 digits or in the form NNN-NN-NNNN.".



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

zeroStartError

Eigenschaft 
zeroStartError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung, wenn der Wert eine ungültige Sozialversicherungsnummer enthält.

Der Standardwert ist "Invalid Social Security number; the number cannot start with 000.".



Implementierung
    public function get zeroStartError():String
    public function set zeroStartError(value:String):void
Konstruktordetails

SocialSecurityValidator

()Konstruktor
public function SocialSecurityValidator()

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

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 — Zu überprüfendes Objekt.

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

validateSocialSecurity

()Methode 
public static function validateSocialSecurity(validator:SocialSecurityValidator, value:Object, baseField:String):Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Vereinfachungsmethode zum Aufrufen eines Validators. Für jeden Standard-Flex-Validator gibt es eine ähnliche Vereinfachungsmethode.

Parameter

validator:SocialSecurityValidator — Die SocialSecurityValidator-Instanz.
 
value:Object — Ein zu überprüfendes Feld.
 
baseField:String — Textdarstellung des im value-Parameter angegebenen Unterfelds. Wenn z. B. der value-Parameter value.social angibt, ist der baseField-Wert social.

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

Verwandte API-Elemente

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

    <s:Panel title="Social Security Validator Panel"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter Social Security number: ">
                <s:TextInput id="ssn" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.