QName  - AS3

Der lokale Name des QName-Objekts.

Der URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner) des QName-Objekts.

Erstellt ein QName-Objekt, das eine Kopie eines anderen QName-Objekts ist. Wenn der an den Konstruktor übergebene Parameter ein QName-Objekt ist, wird eine Kopie des QName-Objekts erstellt. Handelt es sich bei dem Parameter aber nicht um ein QName-Objekt, wird der Parameter in einen String konvertiert und der localName-Eigenschaft der neuen QName-Instanz zugewiesen. Ist der Parameter undefined oder wurde er gar nicht angegeben, wird ein neues QName-Objekt erstellt, wobei die localName-Eigenschaft auf einen leeren String gesetzt ist.

Hinweis: Diese Klasse zeigt zwei Konstruktoreinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Parameter, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.

Erstellt ein QName-Objekt mit einem URI aus einem Namespace-Objekt und localName aus einem QName-Objekt. Hat einer der Parameter nicht den erwarteten Datentyp, wird er in einen String konvertiert und der entsprechenden Eigenschaft des neuen QName-Objekts zugewiesen. Handelt es sich beispielsweise bei beiden Parametern um Strings, wird ein neues QName-Objekt zurückgegeben, dessen uri-Eigenschaft auf den ersten Parameter gesetzt ist und dessen localName-Eigenschaft auf den zweiten Parameter gesetzt ist. Anders ausgedrückt: Die folgenden Permutationen sind, neben vielen anderen, zulässige Formen des Konstruktors:

QName (uri:Namespace, localName:String);
QName (uri:String, localName: QName);
QName (uri:String, localName: String);

Wenn Sie den Wert null an den uri-Parameter übergeben, wird die uri-Eigenschaft des neuen QName-Objekts auf null gesetzt.

Hinweis: Diese Klasse zeigt zwei Konstruktoreinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Parameter, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.

Gibt einen String zurück, der sich aus dem URI und dem lokalen Namen für das QName-Objekt zusammensetzt, wobei die beiden durch „::“ voneinander getrennt sind.

Das Format hängt von der uri-Eigenschaft des QName-Objekts ab:

If uri == "" 
		toString returns localName
	else if uri == null
		toString returns *::localName 
	else
		toString returns uri::localName

Gibt das QName-Objekt zurück.

1. Erstellen Sie eine Namespace-Instanz, und übergeben Sie sie dann an den QName-Konstruktor. Dieser Ansatz ist zu empfehlen, wenn Sie die Namespace.prefix-Eigenschaft später für andere Zwecke verwenden möchten.
2. Erstellen Sie eine QName-Instanz und verwenden Sie einen einfachen Stringwert für den uri-Parameter im QName-Konstruktor.

Dieser Code bewirkt Folgendes:

1. Definiert eine XML-Variable namens rssXML.
2. Erstellt ein neues Namespace-Objekt mit dem Präfix dc.
3. Erstellt ein neues QName-Objekt mithilfe des Namespace-Objekts und dem lokalen Namen creator.
4. Ruft die showDescendants()-Methode auf, die mithilfe der XML.descendants()-Methode eine XMLList-Instanz abruft. Diese Instanz enthält alle untergeordneten Elemente, deren qualifizierte Namen mit der gegebenen QName-Instanz übereinstimmen.
5. Zeigt den qualifizierten Namen und den Textwert jedes aufgelisteten Elements mithilfe einer for each-Schleife an.
6. Erstellt ein weiteres QName-Objekt und verwendet einen Stringwert für den Parameter uri sowie den lokalen Namen date.
7. Ruft die showDescendants()-Methode erneut auf, um den Namen und den Textwert der untergeordneten Elemente anzuzeigen.

package
{
    import flash.display.Sprite;
    
    public class QNameExample extends Sprite
    {
        public function QNameExample()
        {
            var rssXML:XML =  <rdf:RDF
              xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
              xmlns="http://purl.org/rss/1.0/"
              xmlns:dc="http://purl.org/dc/elements/1.1/">
              <channel rdf:about="http://www.xml.com/cs/xml/query/q/19">
                <title>Test RSS</title>
                <link>http://www.adobe.com/</link>
                <description>This is a test RSS document.</description>
                <language>en-us</language>
                <items>
                  <rdf:Seq>
                <rdf:li rdf:resource="http://www.adobe.com/devnet/flash/"/>
                <rdf:li rdf:resource="http://www.adobe.com/devnet/flex/"/>
                  </rdf:Seq>
                </items>
              </channel>
              <item rdf:about="http://www.adobe.com/devnet/flash/">
                <title>Flash Developer Center</title>
                <link>http://www.adobe.com/devnet/flash/</link>
                <description>Welcome to the Flash Developer Center</description>
                <dc:creator>Adobe</dc:creator>
                <dc:date>2005-08-08</dc:date>    
              </item>
              <item rdf:about="http://www.adobe.com/devnet/flex/">
                <title>Flex Developer Center</title>
                <link>http://www.adobe.com/devnet/flex/</link>
                <description>Welcome to the Flex Developer Center</description>
                <dc:creator>Adobe</dc:creator>
                <dc:date>2005-10-16</dc:date>    
              </item>
            </rdf:RDF>;
            
            var dcNamespace:Namespace = new Namespace("dc", "http://purl.org/dc/elements/1.1/");
            var creatorQName:QName = new QName(dcNamespace, "creator");
            trace(creatorQName.uri); // http://purl.org/dc/elements/1.1/
            trace(creatorQName.localName); // creator
            
            showDescendants(rssXML, creatorQName);
            
            var dateQName:QName = new QName("http://purl.org/dc/elements/1.1/", "date");
            trace(dateQName.uri); // http://purl.org/dc/elements/1.1/
            trace(dateQName.localName); // date
            
            showDescendants(rssXML, dateQName);
        }
        
        public function showDescendants(xmlData:XML, qualifiedName:QName):void
        {
            var decendantList:XMLList = xmlData.descendants(qualifiedName);
            
            for each (var element:XML in decendantList)
            {
                trace(element.name()); // the fully qualified name, 
                                       // like "http://purl.org/dc/elements/1.1/::creator"
                trace(element); // the simple text value of each element, like "Adobe"
            }                
        }
    }
}