Isom.Base.Data

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Base.Data

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Base.Data

Beschreibung

Mit dem Typ Isom.Base.Data lassen sich in ISOM/L Datenstrukturen erzeugen. Die Strukturen können als XML-Dateien gespeichert und aus den Dateien wieder geladen werden.



Funktionen

Isom.Base.Data.AddAttribute

Fügt dem Datenobjekt ein Attribut hinzu.

objectbound Isom.Base.Boolean Isom.Base.Data.AddAttribute  ( Isom.Base.String  name,
Isom.Base.String  attr  )

Fügt dem Datenobjekt ein Attribut hinzu.

Falls ein Attribut mit diesem Namen bereits existiert, wird es ersetzt.

Zu beachten:
Wenn ein Attribut ein Präfix verwendet (z.B. xsi:noNamespaceSchemaLocation), dann muss zuvor der Namensraum für das Präfix deklariert worden sein. Ausnahmen davon sind die Standard-Präfixe 'xml' und 'xmlns'.
 Data data = Data.Create("A"); 
 // Namensraum für Präfix 'xsi' deklarieren (mit Standard-Präfix 'xmlns') 
 data.AddAttribute ("xmlns:xsi", "http://www.w3.org/2001/XMLSchema-instance"); 
 // Präfix 'xsi' verwendet 
 data.AddAttribute ("xsi:noNamespaceSchemaLocation", "Beispiel.xsd"); 

 // <A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 //    xsi:noNamespaceSchemaLocation="Beispiel.xsd" /> 
Parameter:
name  Name des Attributs.
attr  Wert des Attributs.
Rückgabe:
'true', falls das Attribut hinzugefügt werden konnte, 'false', falls der Name oder der Wert das Void-Objekt ist oder falls ein Präfix für einen nicht deklarierten Namensraum verwendet wird.
Isom.Base.Data.AddElement

Fügt dem Datenobjekt ein unmittelbares Kindelement hinzu.

objectbound Isom.Base.Boolean Isom.Base.Data.AddElement  ( Isom.Base.Data  value  ) 

Fügt dem Datenobjekt ein unmittelbares Kindelement hinzu.

Das übergebene Datenobjekt wird als letztes Kindelement in die Liste der Kinder des Zielelements eingefügt.

 Data data = Data.Create("A"); 
 Data childElement = Data.Create("B"); 
 data.AddElement(childElement); // "B" ist jetzt Kindelement von "A" 
 Data childChildElement = Data.Create("C"); 
 childElement.AddElement(childChildElement); // "C" ist jetzt Kindelement von "B" 
Parameter:
value  Datenobjekt des Elements.
Rückgabe:
'true', falls das Element hinzugefügt werden konnte, 'false', falls das Datenobjekt das Void-Objekt ist.
Isom.Base.Data.AddGlobal

Speichert eine Kopie dieses Datenobjekts als globale Variable.

Isom.Base.Boolean Isom.Base.Data.AddGlobal  ( Isom.Base.String  key,
Isom.Base.Data  value  )

Speichert eine Kopie dieses Datenobjekts als globale Variable.

Die übergebene Zeichenkette ist der Schlüssel, mit dem die gespeicherte Variable danach mit .GetGlobal() abgerufen werden kann. Existiert bereits eine globale Variable mit dem Schlüssel, wird der vorher gesicherte Wert ersetzt.

 Data data = Data.Create("A"); 
 Data.AddGlobal("A", data); 
Parameter:
key  Schlüssel, mit dem das Objekt als globale Variable gespeichert wird.
value  Datenobjekts, das gespeichert wird.
Rückgabe:
'true', falls das Datenobjekts als globale Variable gespeichert werden konnte, 'false' sonst (z.B. bei einem ungültigen Objekt für Schlüssel oder Wert).
Isom.Base.Data.Clone

Erzeugt eine identische Kopie dieses Objekts.

objectbound Isom.Base.Data Isom.Base.Data.Clone  (  ) 

Erzeugt eine identische Kopie dieses Objekts.

Rückgabe:
Kopie dieses Objekts.
Isom.Base.Data.Create

Erzeugt ein neues, leeres Datenobjekt.

Isom.Base.Data Isom.Base.Data.Create  ( Isom.Base.String  name  ) 

Erzeugt ein neues, leeres Datenobjekt.

Das neu erzeugte Datenobjekt eintspricht einem XML-Knoten mit dem übergebenen Namen.

 Data data = Data.Create("A"); 
Parameter:
name  Name des Datenobjekts.
Rückgabe:
Leeres Datenobjekt.
Isom.Base.Data.CreateFromXml

Erzeugt ein neues Datenobjekt aus einer Zeichenketten.

Isom.Base.Data Isom.Base.Data.CreateFromXml  ( Isom.Base.String  content  ) 

Erzeugt ein neues Datenobjekt aus einer Zeichenketten.

Die Zeichenkette muss gültiges XML sein. Sie kann mit einer XML-Deklaration beginnen (vollständige XML-Datei) oder nur ein Fragment enthalten (einzelner XML-Knoten). Eine ggf. vorhandene XML-Deklaration wird nicht in das Datenobjekt übernommen.

 String xml = "<Root><Entry>Inhalt</Entry></Root>"; 
 Data data = Data.CreateFromXml(xml); 
Parameter:
content  XML als Zeichenkette
Rückgabe:
Das aus der Zeichenkette erzeugte Datenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die Zeichenkette nicht konvertiert werden konnte.
Isom.Base.Data.CreateWithNamespace

Erzeugt ein neues, leeres Datenobjekt in einem Namensraum.

Isom.Base.Data Isom.Base.Data.CreateWithNamespace  ( Isom.Base.String  name,
Isom.Base.String  ns  )

Erzeugt ein neues, leeres Datenobjekt in einem Namensraum.

Das neu erzeugte Datenobjekt eintspricht einem XML-Knoten mit dem übergebenen Namen, der dem angegebenen Namensraum zugeordnet ist.

 Data data = Data.CreateWithNamespace("A", "http://www.ifs.it/irgendwo"); 

 data.WriteXml(...); 
 // <A xmlns="http://www.ifs.it/irgendwo" /> 

Wenn für einen Namensraum bereits ein Alias definiert ist, kann man dieses Alias als Präfix für den Namen verwenden. Der Namensraum wird dann im XML-Dokuemnt nicht noch einmal ausgegeben.

 Data root = Data.CreateWithNamespace("A"); 
 // Präfix 'ifs' definieren 
 root.AddAttribute("xmlns:ifs", "http://www.ifs.it/irgendwo"); 
 // Präfix 'ifs' verwenden (Namensraum muss auch angegeben werden!) 
 Data data = Data.CreateWithNamespace("ifs:B", "http://www.ifs.it/irgendwo"); 
 root.AddElement(data); 

 root.WriteXml(...); 
 // <A xmlns:ifs="http://www.ifs.it/irgendwo"> 
 //     <!-- Namensraum wird im XML-Dokument nur einmal ausgegeben --> 
 //     <ifs:B /> 
 // </A> 
Parameter:
name  Name des Datenobjekts.
name  Namensraum des Datenobjekts.
Rückgabe:
Leeres Datenobjekt.
Isom.Base.Data.FindElements

Sucht mit einem XPath-Ausdruck nach untergeordneten Datenobjekten.

objectbound Isom.Base.DataList Isom.Base.Data.FindElements  ( Isom.Base.String  path  ) 

Sucht mit einem XPath-Ausdruck nach untergeordneten Datenobjekten.

Es werden alle untergeordneten Datenobjekte zurückgegeben, die zu dem XPath-Ausdruck passen.

 Data data = Data.Create("A"); 
 Data childElement = Data.Create("B"); 
 Data childElement2 = Data.Create("C"); 
 childElement.AddElement(childElement2); 
 data.AddElement(childElement); 
 DataList elements = data.FindElements("A/C");    // elements enthält nur das Datenobjekt childElement2 
Parameter:
path  XPath-Ausdruck Der XPath-Ausdruck muss bei der Auswertung eine Knotenliste ergeben. Alle gefundenen Element-Knoten werden in das Ergebnis übernommen. Andere Knoten (z.B. Attribute) werden ignoriert.
Rückgabe:
Liste der Elemente, die dem übergebenen XPath-Ausdruck entsprechen.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der XPath-Ausdruck das Void-Objekt oder leer ist.
Es wird das Void-Objekt zurückgegeben, falls der XPath-Ausdruck ungültig ist oder nicht in einer Knotenliste resultiert.
Isom.Base.Data.GetAttribute

Ruft ein Attribut ab.

objectbound Isom.Base.String Isom.Base.Data.GetAttribute  ( Isom.Base.String  name  ) 

Ruft ein Attribut ab.

Ruft das benannte Attribut des Datenelements ab.

 Data data = Data.Create("A"); 
 data.AddAttribute("X", "1"); 
 String val = data.GetAttribute("X");    // val ist "1" 
 String val = data.GetAttribute("Y");    // val ist Void 
Parameter:
name  Name des Attributs.
Rückgabe:
Wert des Attributs.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der übergebene Name das Void-Objekt ist oder das Datenobjekt kein Attribut mit dem Namen besitzt.
Isom.Base.Data.GetAttributes

Ruft alle Attribute ab.

objectbound Isom.Base.StringDictionary Isom.Base.Data.GetAttributes  (  ) 

Ruft alle Attribute ab.

Ruft alle Attribute des Datenobjekts als Wörterbuch ab.

 Data data = Data.Create("DataWithAttribute"); 
 data.AddAttribute("A", "1"); 
 data.AddAttribute("B", "2"); 
 StringDictionary attributes = data.GetAttributes();    // attributes enthält die Einträge ("A", "1") und ("B", "2") 
Rückgabe:
Zuordnung der Namen aller Attribute des Datenobjekts zu ihren Werten.
Isom.Base.Data.GetDataHandle

Gibt ein DataHandle für das Data-Objekt zurück.

objectbound Isom.Exchange.DataHandle Isom.Base.Data.GetDataHandle  (  ) 

Gibt ein DataHandle für das Data-Objekt zurück.

Der Inhalt, den das DataHandle referenziert, entspricht dem aktuellen Stand des Data-Objekts. Spätere Änderungen werden nicht in den Inhalt des DataHandle-Objekts übernommen.

Rückgabe:
'Isom.Exchange.DataHandle'
Isom.Base.Data.GetElements

Ruft bestimmte Kindelemente ab.

objectbound Isom.Base.DataList Isom.Base.Data.GetElements  ( Isom.Base.String  name  ) 

Ruft bestimmte Kindelemente ab.

Ruft für ein Datenobjekt dessen unmittelbare Kindelemente mit dem übergebenen Namen ab.

 Data data = Data.Create("A"); 
 Data childElement = Data.Create("B"); 
 data.AddElement(childElement); 
 Data childChildElement = Data.Create("C"); 
 childElement.AddElement(childChildElement);   // "C" ist jetzt Kindelement von "B" 
 DataList elementsB = data.GetElements("B");    // elementsB enthält nur das Datenobjekt childElement 
 DataList elementsC = data.GetElements("C");    // elementsC ist eine leere Liste 
Parameter:
name  Name der abgerufenen unmittelbaren Kind-Datenobjekte.
Rückgabe:
Unmittelbare Kind-Datenobjekte mit dem übergebenen Namen.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der übergebene Name das Void-Objekt ist.
Isom.Base.Data.GetExistingGlobals

Ruft die Liste der Schlüssel der globalen Datenobjekte ab.

Isom.Base.StringList Isom.Base.Data.GetExistingGlobals  (  ) 

Ruft die Liste der Schlüssel der globalen Datenobjekte ab.

Ruft eine Liste der Schlüssel aller globalen Variablen des Typs 'Data' ab

   Data data = Data.Create("A"); 
   Data.AddGlobal("A", data); 
   data = Data.Create("B"); 
   Data.AddGlobal("B", data); 
   StringList keys = Data.GetExistingGlobals(); // enthält "A" und "B" 
Rückgabe:
Liste der Schlüssel aller globalen Variablen des Typs 'Data'
Isom.Base.Data.GetGlobal

Ruft ein globales Datenobjekt ab.

Isom.Base.Data Isom.Base.Data.GetGlobal  ( Isom.Base.String  key  ) 

Ruft ein globales Datenobjekt ab.

Ruft das Datenobjekt ab, das unter dem übergebenen Schlüssel als globale Variable gesichert wurde.

 Data value = Data.GetGlobal("A"); 
Parameter:
key  Schlüssel der gesuchten globalen Variable.
Rückgabe:
Kopie des gefundenen Variablenwerts. Änderungen an diesem Rückgabewert ändern den Wert der gesicherten globalen Variable nicht. Um Änderungen in die globale Variable zu übernehmen, muss der geänderte Wert mit .AddGlobal() wieder gesichert werden.
Ausnahmebehandlung:
Die Funktion liefert ein Void-Objekt, falls innerhalb dieser Sitzung noch keine Variable unter dem Schlüssel abgespeichert wurde oder der Schlüssel ein ungültiges Objekt ist.
Isom.Base.Data.GetText

Ruft das Textelement des Datenobjekts ab.

objectbound Isom.Base.String Isom.Base.Data.GetText  (  ) 

Ruft das Textelement des Datenobjekts ab.

Ruft das Textelement des Datenobjekts ab.

 Data data = Data.Create("A"); 
 data.SetText("abc"); 
 String text = data.GetText();    // text ist "abc" 
Rückgabe:
Das Textelement des Datenobjekts.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls dieses Datenobjekt keinen Textwert besitzt.
Isom.Base.Data.IsValid

Validiert das Datenobjekt gegen ein XML-Schema.

objectbound Isom.Base.Boolean Isom.Base.Data.IsValid  ( Isom.Base.Uri  schema  ) 

Validiert das Datenobjekt gegen ein XML-Schema.

Validiert das Datenobjekt gegen ein XML-Schema.

 Data data = Data.LoadXml(uriFile); 
 Boolean valid = data.IsValid(uriSchema); 
Parameter:
schema  XML-Schemadatei
Rückgabe:
'true', falls das Datenobjekt dem XML-Schema entspricht, sonst 'false'
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter 'schema' kein güliges XML-Schema referenziert.
Isom.Base.Data.IsVoid

Bestimmt, ob es sich um das Void-Objekt handelt.

objectbound Isom.Base.Boolean Isom.Base.Data.IsVoid  (  ) 

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Base.Data.LoadText

Erzeugt ein neues Datenobjekt aus einer Textdatei ohne hierarchische Struktur.

Isom.Base.Data Isom.Base.Data.LoadText  ( Isom.Base.Uri  path  ) 

Erzeugt ein neues Datenobjekt aus einer Textdatei ohne hierarchische Struktur.

Der Inhalt der Textdatei wird in einem neu angelegten Datenobjekt mit dem Namen @i Text abgelegt.

 Uri uri = Isom.Base.Uri.DefineUri( "http://localhost/pathA/pathB/file.txt" ); 
 Data data = Data.LoadText(uri); 
 String filecontent = data.GetText(); 
Parameter:
path  URI-Pfadangabe zu der Textdatei.
Rückgabe:
Das aus der Textdatei erzeugte Datenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die Datei nicht geladen werden konnte.
Isom.Base.Data.LoadXml

Erzeugt ein neues Datenobjekt aus einer XML-Datei.

Isom.Base.Data Isom.Base.Data.LoadXml  ( Isom.Base.Uri  path  ) 

Erzeugt ein neues Datenobjekt aus einer XML-Datei.

Der Inhalt des XML-Dokumentknotens der Datei wird dem neu erzeugten Datenobjekt zugewiesen. Die XML-Deklaration wird nicht übernommen.

 Uri uri = Isom.Base.Uri.DefineUri( "http://localhost/pathA/pathB/file.xml" ); 
 Data data = Data.LoadXml(uri); 
Parameter:
path  URI-Pfadangabe zu der XML-Datei.
Rückgabe:
Das aus der XML-Datei erzeugte Datenobjekt.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die Datei nicht geladen werden konnte.
Isom.Base.Data.Query

Sucht in den Daten nach bestimmten Einträgen.

objectbound Isom.Base.StringList Isom.Base.Data.Query  ( Isom.Base.StringList  paths  ) 

Sucht in den Daten nach bestimmten Einträgen.

Der Funktion wird eine Liste von relativen XPath-Ausdrücken übergeben, die für das Datenelement ausgewertet werden. Das Suchergebnis besteht aus einer Liste von Zeichenketten, in der die Ergebnisse der einzelnen XPath-Auswertungen enthalten sind. Die Ergebnisse haben die gleiche Reihenfolge wie die XPath-Ausdrücke.

Wenn ein relativer XPath-Ausdruck ungültig ist oder wenn ein XPath-Ausdruck kein relativer Ausdruck ist, wird im Suchergebnis an der betreffenden Stelle ein Void-Objekt eingetragen.

Wenn die Auswertung eines relativen XPath-Ausdrucks für einen der XML-Knoten in mehreren XML-Knoten resultiert, wird nur der Wert des ersten XML-Knotens in die Suchergebnisse übernommen.

   Uri uri = Isom.Base.Uri.DefineUri( "file:.../ISOM/model/Base_ISOM.xml" ); 

   StringList search = StringList.CreateStringList(); 
   search.Insert( "attribute::IsDefault" );   // oder "@IsDefault" 
   search.Insert( "child::PChannel" );        // oder "PChannel" 

   DataList list = xml.FindElements("//NChannel[@Name='DIAGBUS']"); 
   result = list.Next().Query(search); 
   result.Reset(); 
   while(result.HasNext()) 
   { 
       String found = result.Next(); 
       System.Stdout (found); 
   } 
Parameter:
paths  relative XPath-Ausdrücke.
Rückgabe:
Die Suchergebnisse; die Liste kann auch leer sein oder leere Einträge und Void-Objekte enthalten
Isom.Base.Data.RemoveAttribute

Entfernt ein Attribut.

objectbound Isom.Base.Boolean Isom.Base.Data.RemoveAttribute  ( Isom.Base.String  name  ) 

Entfernt ein Attribut.

Entfernt das genannte Attribut eines Datenobjekts.

 Data data = Data.Create("A"); 
 data.AddAttribute("X", "true"); 
 Boolean a = data.RemoveAttribute("X");     // a ist true 
 Boolean b = data.RemoveAttribute("X");     // b ist false 
Parameter:
name  Name des zu entfernenden Attributs.
Rückgabe:
Angabe, ob das Attribut erfolgreich entfernt wurde. Wird das Void-Objekt als Name übergeben, liefert die Funktion "false".
Isom.Base.Data.RemoveElements

Sucht mit einem XPath-Ausdruck nach Datenobjekten und entfernt sie.

objectbound Isom.Base.Boolean Isom.Base.Data.RemoveElements  ( Isom.Base.String  path  ) 

Sucht mit einem XPath-Ausdruck nach Datenobjekten und entfernt sie.

Alle Datenobjekte, die zu dem übergebenen XPath-Ausdruck passen, werden entfernt.

 Data data = Data.Create("A"); 
 Data childElement = Data.Create("B"); 
 Data childElement2 = CData.reate("C"); 
 childElement.AddElement(childElement2); 
 data.AddElement(childElement); 
 Boolean success = data.RemoveElements("B/C"); 
Parameter:
path  XPath-Ausdruck Der XPath-Ausdruck muss bei der Auswertung eine Knotenliste ergeben. Alle gefundenen Element-Knoten werden in das Ergebnis übernommen. Andere Knoten (z.B. Attribute) werden ignoriert.
Rückgabe:
true wenn alle Elemente entfernt werden konnten, sonst false.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der XPath-Ausdruck das Void-Objekt oder leer ist.
Isom.Base.Data.RemoveGlobal

Entfernt ein globales Datenobjekt.

Isom.Base.Boolean Isom.Base.Data.RemoveGlobal  ( Isom.Base.String  key  ) 

Entfernt ein globales Datenobjekt.

Entfernt ein globales Datenobjekt, das unter dem übergebenen Schlüssel gespeichert wurde.

Parameter:
key  Schlüssel, unter dem die globale Variable abgelegt wurde
Rückgabe:
'true', falls die globale Variable mit dem Schlüssel gelöscht wurde 'false, falls unter dem Schlüssel keine globale Variable abgelegt war.
Isom.Base.Data.RemoveText

Entfernt das Textelement.

objectbound Isom.Base.Boolean Isom.Base.Data.RemoveText  (  ) 

Entfernt das Textelement.

Entfernt das Textelement eines Datenobjekts.

 Data data = Data.Create("A"); 
 data.SetText("abc"); 
 Boolean a = data.RemoveText(); 
Rückgabe:
Angabe, ob der Text erfolgreich entfernt wurde.
Isom.Base.Data.SetNamespaces

Registriert Präfixe für XML-Namesräume, die in XPath-Ausdrücken verwendet werden können

objectbound Isom.Base.Boolean Isom.Base.Data.SetNamespaces  ( Isom.Base.StringDictionary  mapping  ) 

Registriert Präfixe für XML-Namesräume, die in XPath-Ausdrücken verwendet werden können

In XML-Dokumenten können Namensräume angegeben werden. Um mit den Funktionen Isom.Base.Data.FindElements und Isom.Base.Data.Query in einem solchen Dokument suchen zu können, muss der betreffende XPath-Ausdruck Präfixe verwenden. Diese Präfixe wiederum müssen zuvor registriert werden, damit sie dem entsprechenden Namensraum zugeordnet werden können.

Ein Präfix kann mehrfach registriert werden. In diesem Fall ist die letzte Zuordnung gültig.

Die Präfixe 'xml' und 'xmlns' sind reserviert und dürfen nicht verwendet werden.

Dieses Beispiel zeigt ein XML-Dokument mit Namensraum.

 <wurzel xmlns="http://www.ifs-it.de/dieses-Dokument-gibt-es-nicht"> 
     <eintrag> 
         <daten /> 
     </eintrag> 
 </wurzel> 
Zu beachten:
XML-Namensräume sind üblicherweise URLs. Sie müssen jedoch auf kein reales Dokument verweisen. Insbesondere wird auch keine Verbindung aufgebaut, um von einer solchen URL Daten zu laden.
Verwendungsbeispiel:
Das folgende ISOM/L-Programm zeigt, wie in dem oben angeführten XML-Dokument mit einem XPath-Ausdruck gesucht werden kann.
 Isom.Base.Uri  uri = Isom.Base.Uri.DefineUri( "daten.xml" ); 
 Isom.Base.Data input = Isom.Base.Data.LoadXml(uri); 

 // Das Präfix 'ifs' soll für den angegebenen XML-Namensraum verwendet werden. 
 Isom.Base.StringDictionary namespaces = Isom.Base.StringDictionary.CreateStringDictionary(); 
 namespaces.Add("ifs", "http://www.ifs-it.de/dieses-Dokument-gibt-es-nicht"); 

 // Hier wird der NamespaceManager kofiguriert 
 Isom.Base.Boolean result = input.SetNamespaces(namespaces); 

 // XPath-Ausdruck mit Präfix für die Suche im Dokument 
 Isom.Base.DataList matches = input.FindElements("//ifs:eintrag"); 
Bemerkungen:
Die Information über registrierte Namensräume wird an Data-Objekte in den Suchergebnissen weitergegeben. Im oben angeführten ISOM/-L- Beispielprogramm ist in den Suchergebnissen (in der Liste 'matches') das Präfix 'ifs' für den Namensraum bereits registriert.
Parameter:
mapping  Zuordnungen von Präfixen zu Namensräumen
Rückgabe:
'true', falls das Datenobjekt dem XML-Schema entspricht, sonst 'false'
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Parameter 'mapping' Void ist.
Isom.Base.Data.SetNewLineOnXmlAttribute

Ändert das Format der XML-Attribute.

objectbound Isom.Base.Boolean Isom.Base.Data.SetNewLineOnXmlAttribute  ( Isom.Base.Boolean  newLine  ) 

Ändert das Format der XML-Attribute.

Bestimmt ob die XML-Attributen in einer neuen Zeile geschrieben werden

 Data a = ... 
 a.SetNewLineOnXmlAttribute(true); 
 Uri uri = Isom.Base.Uri.DefineUri( "pathX/file.xml" ); 
 a.WriteXml(uri); 

 @param newLine Format der Attribute 
 @return immer 'true' 

Isom.Base.Data.SetText

Setzt das Textelement des Datenobjekts.

objectbound Isom.Base.Boolean Isom.Base.Data.SetText  ( Isom.Base.String  text  ) 

Setzt das Textelement des Datenobjekts.

Setzt das Textelement des Datenobjekts.

 Data data = Data.Create("A"); 
 data.SetText("abc"); 
Parameter:
text  das neue Textelement.
Rückgabe:
'true', falls der Text gesetzt werden konnte, 'false' sonst.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der zu setzende Text das Void-Objekt ist.
Isom.Base.Data.ToXml

Gibt den Inhalt des Datenobjekt als XML-Zeichenkette wieder.

objectbound Isom.Base.String Isom.Base.Data.ToXml  (  ) 

Gibt den Inhalt des Datenobjekt als XML-Zeichenkette wieder.

Der Inhalt des Datenobjekts wird in einer Zeichenkatte als XML-Darstellung abgelegt.

Zu beachten:
Anders als beim Schreiben in ein XML-Dokument (mit Isom.Base.Data.WriteXml) ergänzt diese Funktion keine XML-Deklaration.
 Data data = Data.LoadXml(uriFile); 
 String xml = data.ToXml(); // Inhalt der XML-Datei 
Rückgabe:
Isom.Base.String
Der Inhalt des Datenobjekts als XML-Zeichenkette
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls das Datenobjekt Void ist.
Isom.Base.Data.Void

Erzeugt ein Void-Objekt.

Isom.Base.Data Isom.Base.Data.Void  (  ) 

Erzeugt ein Void-Objekt.

Erzeugt ein Void-Objekt. Das erzeugte Void-Objekt kann z. B. in Funktionen zurückgegeben werden, um einen Fehler anzuzeigen.

Rückgabe:
Void-Objekt
Isom.Base.Data.WriteXml

Schreibt die Daten als XML.

objectbound Isom.Base.Boolean Isom.Base.Data.WriteXml  ( Isom.Base.Uri  path  ) 

Schreibt die Daten als XML.

Schreibt das Datenobjekt als XML in die angegebene Datei. Eine XML-Deklaration wird automatisch ergänzt.

 Data data = Data.Create("A"); 
 Data childElement = Data.Create("B"); 
 Data childElement2 = Data.Create("C"); 
 childElement.AddElement(childElement2); 
 data.AddElement(childElement); 
 Uri uri = Isom.Base.Uri.DefineUri( "http://localhost/pathA/pathB/file.xml" ); 
 Boolean result = data.WriteXml(uri); 
Parameter:
path  Zielpfad der Schreiboperation.
Rückgabe:
Angabe, ob das Schreiben erfolgreich war.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der übergebene Pfad das Void-Objekt ist oder ein Fehler beim Schreibvorgang auftritt.

Version 9.10.1.0 vom 25 November 2013