Den XML-Datenbindungs-Experten verwenden

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu XML-Dokumente mit dem Datenbindungs-Experten abstrahieren


So verwenden Sie den XML-Datenbindungs-Experten:

  1. Wählen Sie Datei > Neu > Weitere und unter Delphi-Projekte aus dem rechten Bereich das Symbol XML-Datenbindung.
  2. Der XML-Datenbindungs-Experte wird angezeigt.
  3. Geben Sie auf der ersten Seite des Experten das XML-Dokument oder Schema an, für das Sie Interfaces generieren möchten. Dabei kann es sich um ein XML-Beispieldokument, eine DTD-Datei (Dokumenttypdefinition), eine XDR-Datei (Reduced XML Data) oder eine XSD-Datei (XML-Schemadatei) handeln.
  4. Klicken Sie auf die Schaltfläche Optionen, um die Benennungsstrategien anzugeben, die der Experte beim Generieren von Interfaces und Implementierungsklassen verwenden soll, und um die Standardzuordnung von im Schema definierten Typen zu nativen Delphi-Datentypen festzulegen.
  5. Fahren Sie mit dem zweiten Dialogfeld des Experten fort. In diesem Dialogfeld können Sie detaillierte Informationen über jeden Knotentyp im Dokument oder Schema angeben. Auf der linken Seite befindet sich eine Strukturansicht, die alle Knotentypen im Dokument anzeigt. Bei komplexen Knoten (Knoten mit untergeordneten Elementen) kann die Strukturansicht erweitert werden, um die untergeordneten Elemente anzuzeigen. Wenn Sie einen Knoten in dieser Strukturansicht auswählen, werden auf der rechten Seite des Dialogfelds Informationen zu diesem Knoten angezeigt, und Sie können dort angeben, wie der Experte diesen Knoten behandeln soll.
    • Das Steuerelement Quellname zeigt den Namen des Knotentyps im XML-Schema an.
    • Das Steuerelement Quelldatentyp zeigt den Typ des Knotenwerts an, wie dieser im XML-Schema angegeben wurde.
    • Mit dem Steuerelement Dokumentation können Sie Kommentare hinzufügen, die die Verwendung oder den Zweck des Knotens beschreiben.
    • Falls der Experte Quellcode für den ausgewählten Knoten generiert (falls es sich also um einen komplexen Typ handelt, für den der Experte ein Interface und eine Implementierungsklasse generiert, oder falls es sich um eines der ungeordneten Elemente eines komplexen Typs handelt, für den der Experte eine Eigenschaft des Interface des komplexen Typs generiert), können Sie mit dem Kontrollkästchen Bindung erzeugen angeben, ob der Experte den Quellcode für den Knoten erstellen soll. Wenn Sie Bindung erzeugen deaktivieren, generiert der Experte kein Interface und keine Implementierungsklasse für einen komplexen Typ bzw. erstellt keine Eigenschaft in dem übergeordneten Interface für das untergeordnete Element oder Attribut.
    • Im Bereich Bindungsoptionen können Sie Einfluss auf den Quellcode nehmen, den der Experte für das ausgewählte Element generiert. Für jeden Knoten können Sie den Bezeichnernamen angeben (den Namen des generierten Interface oder der Eigenschaft). Darüber hinaus müssen Sie bei Interfaces angeben, welches davon den Stammknoten des Dokuments repräsentiert. Für Knoten, die für Eigenschaften stehen, können Sie den Typ der Eigenschaft angeben, und, falls die Eigenschaft kein Interface ist, ob es sich um eine schreibgeschützte Eigenschaft handelt.
  6. Wechseln Sie nach Festlegung des Quellcodes, den der Experte für jeden Knoten generieren soll, zum dritten Dialogfeld. In diesem Dialogfeld können Sie einige globale Optionen auswählen, die steuern, wie der Experte den Quellcode generiert, eine Vorschau des generierten Codes anzeigen und außerdem angeben, wie die gewählten Optionen für die spätere Verwendung gespeichert werden sollen.
    • Um eine Vorschau des vom Experten generierten Quellcodes anzuzeigen, markieren Sie ein Interface in der Liste Bindungs-Info. Die resultierende Interface-Definition wird anschließend im Steuerelement Code-Vorschau angezeigt.
    • Mithilfe der Einstellung für die Datenbindung geben Sie an, wie der Experte die gewählten Optionen speichern soll. Sie können die Einstellungen als Anmerkungen in der Schemadatei speichern, die mit dem Dokument verknüpft ist (d.h. in der auf der ersten Registerkarte des Dialogfelds angegebenen Schemadatei), oder Sie können eine unabhängige Schemadatei angeben, die nur vom Experten verwendet wird.
  7. Wenn Sie auf Fertig stellen klicken, generiert der Datenbindungs-Experte eine neue Unit, die Interfaces und Implementierungsklassen für alle im XML-Dokument enthaltenen Knotentypen definiert. Darüber hinaus erstellt er eine globale Funktion, die ein TXMLDocument-Objekt akzeptiert und das Interface für den Stammknoten der Datenhierarchie zurückgibt.

Siehe auch