DataGridColumnStyle.HeaderText プロパティ

列ヘッダーのテキストを取得または設定します。

Public Overridable Property HeaderText As String
[C#]
public virtual string HeaderText {get; set;}
[C++]
public: __property virtual String* get_HeaderText();public: __property virtual void set_HeaderText(String*);
[JScript]
public function get HeaderText() : String;public function set HeaderText(String);

プロパティ値

列ヘッダーとして表示される文字列。文字列が DataGrid によって作成される場合、既定値は列の作成に使用した PropertyDescriptor の名前です。文字列がユーザーによって作成される場合、既定値は空の文字列 ("") です。

解説

通常、 HeaderText プロパティは、 MappingName 値がわかりにくい場合に、 MappingName 値と異なるキャプションを表示するために使用します。たとえば "FName" の場合に、 HeaderText を "First Name" に変更できます。

使用例

[Visual Basic, C#, C++] HeaderText プロパティを新しい値に設定する例を次に示します。

 
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 'SetHeaderText

[C#] 
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;
}
 

[C++] 
private:
void SetHeaderText()
{
    DataGridColumnStyle* dgCol;
    DataColumn* dataCol1;
    DataTable* dataTable1;
    dgCol = dataGrid1->TableStyles->Item[0]->GridColumnStyles->Item[0];
    dataTable1 = dataSet1->Tables->Item[dataGrid1->DataMember];
    dataCol1 = dataTable1->Columns->Item[dgCol->MappingName];
    dgCol->HeaderText = dataCol1->Caption;
}
 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataGridColumnStyle クラス | DataGridColumnStyle メンバ | System.Windows.Forms 名前空間 | ColumnName | Caption