2.45 :transform()

Transformiert das Objekt mit dem angegebenem Schema. Wenn das Ziel ein XML-Dokument ist, wird der gespeicherte DOM-Baum gelöscht und ein neuer DOM-Baum aufgebaut. Alle bestehenden XML-Cursor werden ungültig.Bei einem ungültigen XML-Cursor besitzt das Attribut .mapped den Wert false.

Alternativ kann das Ziel der Transformation auch ein Text oder eine Datei sein. Ist das Resultat der Wandlung kein legales XML-Format, dann muss direkt in einen Text oder eine Datei gewandelt werden, da das Resultat nicht einem XML-Dokument zugewiesen werden kann. Dies ist zum Beispiel der Fall, wenn zu HTML gewandelt wird.

Definition

boolean :transform
(
      object   Schema input
  { , anyvalue Target := null        input output }
  { , enum     Type   := type_object input }
)

Parameter

object Schema input
Ist das XSL-Transformation-Dokument, mit dem transformiert wird. Der Parameter muss ein XML-Dokument sein.
anyvalue Target := null input output

Optionaler Parameter, ist das Ziel der Transformation. Ist der Parameter weggelassen, dann wird das this-Objekt als Ziel genommen. Der Parameter kann von folgenden Typen sein:

object Target input
Der Parameter ist Eingabeparameter und muss ein XML-Dokument darstellen. Der gespeicherte DOM-Baum wird gelöscht und ein neuer DOM-Baum gemäß der Transformation aufgebaut.
string Target input output
Abhängig vom Type-Parameter ist der Parameter ein Eingabeparameter und gibt einen Dateinamen an oder es ist ein Ausgabeparameter und erhält den String, der durch die Transformation entstanden ist.
enum Type := type_object input

Optionaler Parameter, gibt die Art der Wandlung an. Mögliche Werte sind:

type_file
Gibt an, dass der Target-Parameter eine Datei bezeichnet.
type_object
Gibt an, dass der Target-Parameter ein XML-Dokument ist. Dieser Wert wird standardmäßig angenommen, wenn der Target-Parameter vom Typ object ist.
type_text
Gibt an, dass der Target-Parameter ein Ausgabeparameter vom Typ string ist. Dieser Wert wird standardmäßig angenommen, wenn der Target-Parameter vom Typ string ist.

Rückgabewert

Gibt an, ob die Transformation erfolgreich war.

Im Fehlerfall bleibt der DOM-Baum des Target-XML-Dokuments erhalten oder wird gelöscht, eine teilweise Transformation gibt es nicht.

Objekte mit dieser Methode