XMLName Property

Contains the following for the specified objects:

XMLAdapter: XMLName contains the name of the element that specifies where to look for table elements. Read/write.

For more information about how the XMLAdapterLoadXML and Attach methods set this property, see the Remarks section.

XMLTable: XMLName contains the element name for that table in the XML document. Read-only when associated with an XMLAdapter object.

XMLField: XMLName contains the element or attribute name for that field in the XML document. Read-only when attached to an XMLTable object.

Object.XMLName

Property Values

Character data type. XMLName contains a Unicode character string or is empty ("") when not populated.

Note   Before assigning a string value to XMLName, you must convert the value to Unicode. You can use the STRCONV( ) function to perform this requirement.

Remarks

The XMLAdapterLoadXML and Attach methods set the XMLAdapterXMLName property as follows:

  • ADO.NET DataSet element name for ADO.NET DataSet
  • "data" for ADO Recordset XML
  • Empty string ("") for Microsoft XML Data Reduced Schema (XDR) as used by Microsoft SQL-XML

If XMLAdapterXMLName is empty, XMLTableToCursor looks for table elements within element referenced by the XMLAdapterIXMLDOMElement property.

The XMLAdapterToXML method uses the XMLAdapterXMLName as the DataSet element name. If XMLName is empty, ToXML uses the string, "VFPDataSet".

The XMLTableChangesToCursor and ApplyDiffgram methods require that XMLAdapterXMLName be set to a nonempty value and that the XML document is in DiffGram format.

See Also

Properties | XMLAdapter Object Properties, Methods, and Events | XMLTable Object Properties, Methods, and Events | XMLField Object Properties, Methods, and Events | LoadXML Method | Attach Method | STRCONV( ) Function | ToCursor Method | IXMLDOMElement Property | ToXML Method | XMLName Property | ChangesToCursor Method | ApplyDiffgram Method

Applies To: XMLAdapter Class | XMLTable Class | XMLField Class