TXMLBroker.MasterRowSetVarName Method

Returns the name of the javascript variable for the XML broker's dataset.

Pascal

function MasterRowSetVarName(Path: TStrings): string;

C++

__fastcall AnsiString MasterRowSetVarName(TStrings Path);

Description

When the InternetExpress page producer assembles an HTML document that uses the XML data packets managed by the XML broker, it declares a javascript variable of type RowSet for the javascript object that represents the XML broker's dataset. When the variable is first declared, the InternetExpress page producer calls MasterRowSetVarName.

Path is a set of variable names for all the master datasets for which the XML broker's dataset is a detail set. These names come from previous calls to the MasterRowSetVarName method of their XML brokers. The last string in Path refers to the XML broker's dataset itself.

MasterRowSetVarName returns the name of the XML broker, qualified by all strings in Path except for the last one, which is assumed to refer to the XML broker's dataset. Thus, to change the name of the generated variable for an XML broker's dataset, change the Name property of the XML broker.

Note: To retrieve the name of the XML broker preceded by all the datasets in Path, use the RowSetVarName method instead.