2.271.4 CustomData.DataSetName

Applies to RDL 2005/01, RDL 2008/01, RDL 2010/01, and RDL 2016/01

The CustomData.DataSetName element specifies the name of a DataSet to use for a CustomReportItem. This element is optional and MUST NOT be specified more than once. If this element is present, its value MUST be a String ([XMLSCHEMA2/2] section 3.2.1). The value of this element MUST be one of the Dataset.Name attribute values of a Report.

If the CustomData has an ancestor, the value of the CustomData.DataSetName element is interpreted as the DataSet.Name for the containing scope (DataRegion, Group, or Cell).<57>

If the custom report item has a DataRegion element ancestor, the value of the CustomData.DataSetName element is ignored; the value of the DataSetName element ancestor of the DataRegion MUST be used instead. A DataRegion can be a List, Table, Matrix, Chart, Tablix, GaugePanel, or Map.

If the custom report item has no DataRegion element ancestor and there is more than one dataset for the containing report, the value of the CustomData.DataSetName element MUST be specified.

If no value is specified for the CustomData.DataSetName element and the containing report has only one DataSet specified, the value of the CustomData.DataSetName element is interpreted as being the value of the DataSet.Name attribute for that dataset.

Following is the parent element of the CustomData.DataSetName element.

Parent elements

CustomData

The following is the XML Schema definition of the CustomData.DataSetName element.

 <xsd:element name="DataSetName" type="xsd:string" />