Edit

Share via


DataGridColumnStyle.HeaderText Property

Definition

Gets or sets the text of the column header.

public:
 virtual property System::String ^ HeaderText { System::String ^ get(); void set(System::String ^ value); };
public virtual string HeaderText { get; set; }
member this.HeaderText : string with get, set
Public Overridable Property HeaderText As String

Property Value

A string that is displayed as the column header. If it is created by the DataGrid, the default value is the name of the PropertyDescriptor used to create the column. If it is created by the user, the default is an empty string ("").

Examples

The following code example sets the HeaderText property to a new value.

void SetHeaderText()
{
   DataGridColumnStyle^ dgCol;
   DataColumn^ dataCol1;
   DataTable^ dataTable1;
   dgCol = dataGrid1->TableStyles[ 0 ]->GridColumnStyles[ 0 ];
   dataTable1 = dataSet1->Tables[ dataGrid1->DataMember ];
   dataCol1 = dataTable1->Columns[ dgCol->MappingName ];
   dgCol->HeaderText = dataCol1->Caption;
}
private void SetHeaderText()
{
    DataGridColumnStyle dgCol;
    DataColumn dataCol1;
    DataTable dataTable1;
    dgCol = dataGrid1.TableStyles[0].GridColumnStyles[0];
    dataTable1 = dataSet1.Tables[dataGrid1.DataMember];
    dataCol1 = dataTable1.Columns[dgCol.MappingName];
    dgCol.HeaderText = dataCol1.Caption;
}
Private Sub SetHeaderText()
    Dim dgCol As DataGridColumnStyle
    Dim dataCol1 As DataColumn
    Dim dataTable1 As DataTable
    dgCol = dataGrid1.TableStyles(0).GridColumnStyles(0)
    dataTable1 = dataSet1.Tables(dataGrid1.DataMember)
    dataCol1 = dataTable1.Columns(dgCol.MappingName)
    dgCol.HeaderText = dataCol1.Caption
End Sub

Remarks

The HeaderText property is typically used to display a caption that is different from the MappingName value when the MappingName value isn't easily understandable. For example, you can change the HeaderText to "First Name" when the MappingName value is "FName".

Applies to

See also