DataGridColumnStyle.HeaderText Propriedade

Definição

Obtém ou define o contexto do cabeçalho da coluna.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

Valor da propriedade

String

Uma cadeia de caracteres que é exibida como o cabeçalho da coluna.A string that is displayed as the column header. Se for criado pelo DataGrid , o valor padrão será o nome do PropertyDescriptor usado para criar a coluna.If it is created by the DataGrid, the default value is the name of the PropertyDescriptor used to create the column. Se ele for criado pelo usuário, o padrão será uma cadeia de caracteres vazia ("").If it is created by the user, the default is an empty string ("").

Exemplos

O exemplo de código a seguir define a HeaderText propriedade como um novo valor.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

Comentários

A HeaderText propriedade normalmente é usada para exibir uma legenda diferente do MappingName valor quando o MappingName valor não é facilmente compreensível.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. Por exemplo, você pode alterar o HeaderText para "First Name" quando o MappingName valor for "fname".For example, you can change the HeaderText to "First Name" when the MappingName value is "FName".

Aplica-se a

Confira também