DataGridColumnStyle.HeaderText 属性

获取或设置列标头的文本。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
<LocalizableAttribute(True)> _
Public Overridable Property HeaderText As String
用法
Dim instance As DataGridColumnStyle
Dim value As String

value = instance.HeaderText

instance.HeaderText = value

[LocalizableAttribute(true)] 
public virtual string HeaderText { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property String^ HeaderText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_HeaderText ()

/** @property */
public void set_HeaderText (String value)

public function get HeaderText () : String

public function set HeaderText (value : String)

属性值

作为列标题显示的字符串。如果它是由 DataGrid 创建的，则默认值是用于创建该列的 PropertyDescriptor 的名称。如果它是由用户创建的，则默认值是一个空的字符串 ("")。

备注

HeaderText 属性通常用于在 MappingName 值不易理解时，显示与 MappingName 值不同的标题。例如，您可以在 MappingName 值为“FName”时将 HeaderText 更改为“First Name”。

示例

下面的代码示例将 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

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;
}
 

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.get_TableStyles(). get_Item(0).
        get_GridColumnStyles().get_Item(0);
    dataTable1 = dataSet1.get_Tables().get_Item(dataGrid1.get_DataMember());
    dataCol1 = dataTable1.get_Columns().get_Item(dgCol.get_MappingName());
    dgCol.set_HeaderText(dataCol1.get_Caption());
} //SetHeaderText

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

DataGridColumnStyle 类
DataGridColumnStyle 成员
System.Windows.Forms 命名空间
ColumnName
Caption