combit List & Label 30 - .NET Help
combit.Reporting.DataProviders Namespace / XmlDataProvider Class
Properties Events

XmlDataProvider Class Members

The following tables list the members exposed by XmlDataProvider.

Public Constructors
 NameDescription
Public ConstructorOverloaded.   
Top
Public Properties
 NameDescription
Public PropertyThe IXPathNavigable to use (e.g. XPathDocument). (Default: Null)  
Public PropertyNodes that don't have any attributes are passed as flat.  
Public Property

Gets or sets if the structure of the XML should be parsed as flat as possible. Without this setting, a structure like

 <xml>
 <Company>
  <Address>
    Buecklestr. 3-5
  </Address>
 </Company>
</xml>

would trigger the creation of a "Company" table and a subordinate "Address" table in the data source. If you set this property to "true", you'll get a "Company" table and a string field "Address" within it.

 
Public PropertyGets or sets if the whole XML file should be parsed to determine the available fields and tables or if just the first element should be parsed. If you can make sure that all your XML elements contain the same fields and attributes, you can increase Designer startup performance especially for huge files by setting this property to true. However, if attributes may be present on one element but missing on the first (e.g. a person might have an <Adresses> sub-element but the first person has no addresses), you should leave this property at it's default setting - false.  
Public Property

When FlattenStructure is enabled, ParseFirstElementOnly will always be regarded as true. Therefore a column would not be added to the data structure if it was empty in the first row of a table (first childnode of the corresponding XML element). If this option is set to true, empty XML nodes will be registered as columns even when FlattenStructure is enabled.

 
Public PropertyThe path of the file that contains the XML data. (Default: Null)  
Public Property

Gets or sets the field name to be used for the actual value. While attributes are a convenient way to name values, the XML structure may also contain tags like

<Person Age="27">John Doe</Person>

This property determines the field name for "John Doe", in this case, "Name" would be appropriate as value. The default value for this property is "value".

Please note that this property has to be set before you pass the provider as data source to List & Label.

 
Top
Public Events
 NameDescription
Public EventEnables the application to override the NodeType detection logic of the XmlDataProvider.  
Public EventAllows to override the default data type parsing behavior.  
Top
See Also