ActiveReports3 Request technical support
DataField Property
See Also  Example


Gets or sets the name of the field used to group the data source records.

Syntax

Visual Basic (Declaration) 
Public Property DataField As String
Visual Basic (Usage)Copy Code
Dim instance As GroupHeader
Dim value As String
 
instance.DataField = value
 
value = instance.DataField
C# 
public string DataField {get; set;}

Return Value

A string value that represents the name of the field to be grouped.

Example

C#Copy Code
private void groupHeader1_Format(object sender, System.EventArgs eArgs)
{
   this.groupHeader1.ColumnLayout = true;
   this.groupHeader1.DataField = "Country";
}
Visual BasicCopy Code
Private Sub GroupHeader1_Format(ByVal sender As Object, ByVal e As System.EventArgs) Handles GroupHeader1.Format
   Me.GroupHeader1.ColumnLayout = True
   Me.GroupHeader1.DataField = "Country"
End Sub

Remarks

ActiveReports checks for any changes in the value of the specified field and starts a new group when the value changes.  Current groups are ended (i.e. the group footer section is printed) before the new group is started.

The specified field can originate from the data source or an unbound field added to the Fields collection in the DataInitialize event.

See Also