DataField Property (GroupHeader)

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

Syntax

Visual Basic
C#

'Declaration
 
Public Property DataField As String

public string DataField {get; set;}

Property Value

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

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.

Example

private void groupHeader1_Format(object sender, System.EventArgs eArgs)
{
    this.groupHeader1.ColumnLayout = true;
    this.groupHeader1.DataField = "Country";
}

Visual Basic

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

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GroupHeader Class
GroupHeader Members