DataGridColumnStyle.HeaderText DataGridColumnStyle.HeaderText DataGridColumnStyle.HeaderText DataGridColumnStyle.HeaderText Property


列ヘッダーのテキストを取得または設定します。Gets or sets the text of the column header.

 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


列ヘッダーとして表示される文字列。A string that is displayed as the column header. 文字列が DataGrid によって作成される場合、既定値は列の作成に使用した PropertyDescriptor の名前です。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 ("").

次のコード例ではHeaderText 、プロパティを新しい値に設定します。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


通常HeaderText 、プロパティは、値が簡単に理解できない場合MappingNameMappingName 、値とは異なるキャプションを表示するために使用されます。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. たとえば、 MappingName値が "FName" HeaderTextの場合、を "First Name" に変更できます。For example, you can change the HeaderText to "First Name" when the MappingName value is "FName".