Datasnap.Xmlxform.TXMLTransformClient.SetParams

Übergeordnet: TXMLTransformClient

Delphi

procedure SetParams(const ParamsXml, ParamsTransformFile: string);

C++

void __fastcall SetParams(const System::UnicodeString ParamsXml, const System::UnicodeString ParamsTransformFile);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	Datasnap.Xmlxform.pas Datasnap.Xmlxform.hpp	Datasnap.Xmlxform	TXMLTransformClient

Beschreibung

Weist die Eingabeparameter den Werten eines XML-Dokuments zu.

Mit SetParams können Sie die Werte der Eingabeparameter angeben, bevor die Daten von der Provider-Komponente abgerufen werden. Diese Werte können beispielsweise für die Parameter einer Abfrage oder Stored Procedure und zum Filtern von Datensätzen verwendet werden, wenn der Provider die Daten einer TTable- oder TSQLTable-Komponente bereitstellt.

ParamsXML gibt das XML-Dokument mit den Parameterwerten an. Normalerweise wird dazu eine XML-Datei verwendet.

ParamsTransformFile enthält den Namen der Transformationsdatei für die Konvertierung. Eine Transformationsdatei ist eine spezielle XML-Datei mit der Namenserweiterung XTR. Sie entspricht einem bestimmten XML-Schema oder Datenpaketformat. Transformationsdateien können mit dem Dienstprogramm xmlmapper.exe erstellt werden.

Anmerkung: Wenn in der Transformationsdatei benutzerdefinierte Konvertierungen definiert sind, generiert die in TransformSetParams angegebene Komponente ein OnTranslate-Ereignis, sobald benutzerdefinierte Knoten in ParamsXml in die entsprechenden Parameterwerte umgewandelt werden müssen.

Die TXMLTransformClient-Komponente speichert die Parameterwerte intern. Die Werte werden bei jedem Aufruf von SetParams aktualisiert. Die Werte der vorhergehenden Aufrufe werden aber nicht gelöscht. Weisen Sie daher jeden Parameter zu, den Sie ändern möchten.

Die aktuellen Parameterwerte werden beim nächsten Aufruf der Methode GetDataAsXml an die Provider-Komponente gesendet.