CreditCardValidator

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die CreditCardValidator-Klasse überprüft die Länge der Kreditkartennummer sowie die Richtigkeit des Präfix und übergibt den Luhn mod10-Algorithmus für den jeweiligen Kartentyp. Der Validator überprüft nicht, ob die Kreditkarte tatsächlich ein aktives Kreditkartenkonto ist.

Sie haben für die Eingabe im CreditCardValidator zwei Möglichkeiten:

Verwenden Sie die cardNumberSource- und cardNumberProperty-Eigenschaften, um die Position der Kreditkartennummer anzugeben, und die cardTypeSource- und cardTypeProperty-Eigenschaften, um die Position des zu überprüfenden Kreditkartentyps anzugeben.
Verwenden Sie die source- und property-Eigenschaften, um ein einzelnes Objekt anzugeben. Das Objekt sollte die nachstehenden Felder enthalten:
- cardType - Gibt den Typ der zu überprüfenden Kreditkarte an.
  In MXML verwenden Sie die Werte: "American Express", "Diners Club", "Discover", "MasterCard" oder "Visa".
  
  In ActionScript verwenden Sie die statischen Konstanten CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA oder CreditCardValidatorCardType.AMERICAN_EXPRESS CreditCardValidatorCardType.DISCOVER oder CreditCardValidatorCardType.DINERS_CLUB.
- cardNumber - Gibt die Nummer der zu überprüfenden Karte an.

Für eine Überprüfung werden die nachstehenden Richtlinien verwendet:

Länge:

Visa: 13 oder 16 Ziffern
MasterCard: 16 Ziffern
Discover: 16 Ziffern
American Express: 15 Ziffern
Diners Club: 14 Ziffern oder 16 Ziffern, wenn sie auch als MasterCard verwendet werden kann

Präfix:

Visa: 4
MasterCard: 51 bis 55
Discover: 6011
American Express: 34 oder 37
Diners Club: 300 bis 305, 36 oder 38, 51 bis 55

MXML-Syntax expanded

MXML-Syntax ausblenden

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

  <mx:CreditCardValidator
    allowedFormatChars=" -" 
    cardNumberListener="Object specified by cardNumberSource"
    cardNumberProperty="No default"
    cardNumberSource="No default"
    cardTypeListener="Object specified by cardTypeSource"
    cardTypeProperty="No default"
    cardTypeSource="No default"
    invalidCharError= "Invalid characters in your credit card number. (Enter numbers only.)"
    invalidNumberError="The credit card number is invalid." 
    noNumError="No credit card number is specified."
    noTypeError="No credit card type is specified or the type is not valid." 
    wrongLengthError="Your credit card number contains the wrong number of digits." 
    wrongTypeError="Incorrect card type is specified." 
  />

Beispiele anzeigen

Verwandte API-Elemente

mx.validators.CreditCardValidatorCardType

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		allowedFormatChars : String Satz der im cardNumber-Feld zulässigen Formatierungszeichen.	CreditCardValidator
		cardNumberListener : IValidatorListener Die Komponente, die das Überprüfungsergebnis für das Unterfeld der Kartennummer abwartet.	CreditCardValidator
		cardNumberProperty : String Name der zu überprüfenden Kartennummerneigenschaft.	CreditCardValidator
		cardNumberSource : Object Objekt, das den Wert des Kartennummernfelds enthält.	CreditCardValidator
		cardTypeListener : IValidatorListener Die Komponente, die das Überprüfungsergebnis für das Unterfeld des Kartentyps abwartet.	CreditCardValidator
		cardTypeProperty : String Name der zu überprüfenden Kartentypeigenschaft.	CreditCardValidator
		cardTypeSource : Object Objekt, das den Wert des Kartentypfelds enthält.	CreditCardValidator
		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 das cardNumber-Feld ungültige Zeichen enthält.	CreditCardValidator
		invalidNumberError : String Fehlermeldung, wenn die Kreditkartennummer ungültig ist.	CreditCardValidator
		listener : Object Gibt den Überprüfungs-Listener an.	Validator
		noNumError : String Fehlermeldung, wenn das cardNumber-Feld leer ist.	CreditCardValidator
		noTypeError : String Fehlermeldung, wenn das cardType-Feld leer ist.	CreditCardValidator
		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
		wrongLengthError : String Fehlermeldung, wenn das cardNumber-Feld die falsche Anzahl von Ziffern für den angegebenen Kartentyp enthält.	CreditCardValidator
		wrongTypeError : String Fehlermeldung, wenn das cardType-Feld einen ungültigen Kreditkartentyp enthält.	CreditCardValidator

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
		CreditCardValidator() Konstruktor.	CreditCardValidator
		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
		validateCreditCard(validator:CreditCardValidator, value:Object, baseField:String):Array [statisch] Vereinfachungsmethode zum Aufrufen eines Validators.	CreditCardValidator
		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 Kreditkartennummer.	CreditCardValidator
		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

Satz der im cardNumber-Feld zulässigen Formatierungszeichen.

Der Standardwert ist " -" (space and dash).

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

cardNumberListener

Eigenschaft

cardNumberListener:IValidatorListener

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Komponente, die das Überprüfungsergebnis für das Unterfeld der Kartennummer abwartet. Fehlt eine Angabe, ist der Wert zu verwenden, der für die cardNumberSource-Eigenschaft angegeben ist.

Implementierung
public function get cardNumberListener():IValidatorListener
public function set cardNumberListener(value:IValidatorListener):void

cardNumberProperty

Eigenschaft

public var cardNumberProperty:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Name der zu überprüfenden Kartennummerneigenschaft. Dieses Attribut ist optional, aber wenn Sie die carNumberSource-Eigenschaft angeben, sollten Sie auch diese Eigenschaft einstellen.

cardNumberSource

Eigenschaft

cardNumberSource:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Objekt, das den Wert des Kartennummernfelds enthält. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie auch einen Wert für die cardNumberProperty-Eigenschaft angeben. Verwenden Sie diese Eigenschaft nicht, wenn Sie die source- und property-Eigenschaften setzen.

Implementierung
public function get cardNumberSource():Object
public function set cardNumberSource(value:Object):void

cardTypeListener

Eigenschaft

cardTypeListener:IValidatorListener

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Komponente, die das Überprüfungsergebnis für das Unterfeld des Kartentyps abwartet. Fehlt eine Angabe, ist der Wert zu verwenden, der für die cardTypeSource-Eigenschaft angegeben ist.

Implementierung
public function get cardTypeListener():IValidatorListener
public function set cardTypeListener(value:IValidatorListener):void

cardTypeProperty

Eigenschaft

public var cardTypeProperty:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Name der zu überprüfenden Kartentypeigenschaft. Dieses Attribut ist optional, aber wenn Sie die carTypeSource-Eigenschaft angeben, sollten Sie auch diese Eigenschaft einstellen.

In MXML lauten die zulässigen Werte:

"American Express"
"Diners Club"
"Discover"
"MasterCard"
"Visa"

In ActionScript können Sie folgende Konstanten verwenden, um diese Eigenschaft festzulegen:

CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DINERS_CLUB, CreditCardValidatorCardType.DISCOVER, CreditCardValidatorCardType.MASTER_CARD und CreditCardValidatorCardType.VISA.

Verwandte API-Elemente

mx.validators.CreditCardValidatorCardType

cardTypeSource

Eigenschaft

cardTypeSource:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Objekt, das den Wert des Kartentypfelds enthält. Wenn Sie einen Wert für diese Eigenschaft angeben, müssen Sie auch einen Wert für die cardTypeProperty-Eigenschaft angeben. Verwenden Sie diese Eigenschaft nicht, wenn Sie die source- und property-Eigenschaften setzen.

Implementierung
public function get cardTypeSource():Object
public function set cardTypeSource(value:Object):void

invalidCharError

Eigenschaft

invalidCharError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das cardNumber-Feld ungültige Zeichen enthält.

Der Standardwert ist "Invalid characters in your credit card number. (Enter numbers only.)".

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

invalidNumberError

Eigenschaft

invalidNumberError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn die Kreditkartennummer ungültig ist.

Der Standardwert ist "The credit card number is invalid.".

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

noNumError

Eigenschaft

noNumError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das cardNumber-Feld leer ist.

Der Standardwert ist "No credit card number is specified.".

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

noTypeError

Eigenschaft

noTypeError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das cardType-Feld leer ist.

Der Standardwert ist "No credit card type is specified or the type is not valid.".

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

wrongLengthError

Eigenschaft

wrongLengthError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das cardNumber-Feld die falsche Anzahl von Ziffern für den angegebenen Kartentyp enthält.

Der Standardwert ist "Your credit card number contains the wrong number of digits.".

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

wrongTypeError

Eigenschaft

wrongTypeError:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fehlermeldung, wenn das cardType-Feld einen ungültigen Kreditkartentyp enthält. Sie sollten die vordefinierten Konstanten für das cardType-Feld verwenden: CreditCardValidatorCardType.MASTER_CARD, CreditCardValidatorCardType.VISA, CreditCardValidatorCardType.AMERICAN_EXPRESS, CreditCardValidatorCardType.DISCOVER oder CreditCardValidatorCardType.DINERS_CLUB.

Der Standardwert ist "Incorrect card type is specified.".

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

Konstruktordetails

()

Konstruktor

public function CreditCardValidator()

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

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

Rückgabewerte

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

validateCreditCard

()

Methode

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

	`value:Object` — Ein zu überprüfendes Feld, das die nachstehenden Felder enthalten muss: `cardType` - Gibt den Typ der zu überprüfenden Kreditkarte an. Verwenden Sie die statischen Konstanten `CreditCardValidatorCardType.MASTER_CARD`, `CreditCardValidatorCardType.VISA`, `CreditCardValidatorCardType.AMERICAN_EXPRESS`, `CreditCardValidatorCardType.DISCOVER` oder `CreditCardValidatorCardType.DINERS_CLUB`. `cardNumber` - Gibt die Nummer der zu überprüfenden Karte an.

	`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

CreditCardValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CreditCardValidator. -->
<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>
        <!-- Define model for the credit card data. -->
        <fx:Model id="creditcard">
            <card>
                <cardType>{cardTypeCombo.selectedItem.data}</cardType>
                <cardNumber>{cardNumberInput.text}</cardNumber>
            </card>
        </fx:Model>

        <mx:CreditCardValidator id="ccV" 
                cardTypeSource="{creditcard}" cardTypeProperty="cardType"
                cardNumberSource="{creditcard}" cardNumberProperty="cardNumber"
                trigger="{myButton}" triggerEvent="click"
                cardTypeListener="{cardTypeCombo}"
                cardNumberListener="{cardNumberInput}"
                valid="Alert.show('Validation Succeeded!');"/>
    </fx:Declarations>

    <s:Panel title="CreditCardValidator Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form id="creditCardForm" left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Card Type">
                <mx:ComboBox id="cardTypeCombo">
                    <mx:dataProvider>
                        <fx:Object label="American Express" data="American Express"/>
                        <fx:Object label="Diners Club" data="Diners Club"/>
                        <fx:Object label="Discover" data="Discover"/>
                        <fx:Object label="MasterCard" data="MasterCard"/>
                        <fx:Object label="Visa" data="Visa"/>
                    </mx:dataProvider>
                </mx:ComboBox>
            </mx:FormItem>
            <mx:FormItem label="Credit Card Number">
                <s:TextInput id="cardNumberInput"/>
            </mx:FormItem>
            <mx:FormItem>
                <s:Button id="myButton" label="Check Credit"/>
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

CreditCardValidator - AS3 Flex

Paketex

Sprachelemente

Anhänge

Paket mx.validators

allowedFormatChars

cardNumberListener

cardNumberProperty

cardNumberSource

cardTypeListener

cardTypeProperty

cardTypeSource

invalidCharError

invalidNumberError

noNumError

noTypeError

wrongLengthError

wrongTypeError