GetAttributeByName (Methode)

Übersicht

Typ	Method
Verfügbar ab	V1.3.2.0

Funktionsbeschreibung

Diese Methode ermöglicht es, den Wert des angegebenen Attributs des ausgewählten Elements zu lesen.

Der Rückgabewert des Typs BOOL entspricht TRUE, wenn das Attribut gefunden wurde.

Bei Aufruf dieser Methode wird Ok, NoElementSelected, AttributeNotFound oder InvalidInput zurückgegeben. Verwenden Sie die Eigenschaft Result, um das Ergebnis der Methode abzurufen.

Wenn q_sValue eine Null-Zeichenfolge ist, wurde entweder kein Element ausgewählt, das Attribut wurde nicht gefunden oder es weist keinen Wert auf. Der Wert von q_sValue ist nur gültig, wenn der Rückgabewert der Methode TRUE entspricht.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_sAttribute	STRING [Gc_uiXmlLengthOfString]	Name des Attributs.

Ausgang	Datentyp	Beschreibung
q_sValue	STRING [Gc_uiXmlLengthOfString]	Wert des angegebenen Attributs.

Beispiel

Voraussetzung: Die XML-Datei (nachstehend illustriert) wurde mit dem FB_XmlRead gelesen und der Inhalt im Array astXmlFile des Typs XmlItems gespeichert.

Code:

fbXmlItems.SelectElement('/root/A1', astXmlData);
IF fbXmlItems.GetAttributeByName('a1', sValue) THEN
  // do something with sValue
END_IF

Ergebnis:

Die Variable sValue stellt den Wert 'A1-1' bereit.