DataGridColumnStyle.HeaderText Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Text des Spaltenkopfs ab oder legt diesen fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die als Spaltenkopf angezeigt wird. Wenn sie durch das DataGrid-Objekt erstellt wird, ist der Standardwert der Name des PropertyDescriptor, mit dem die Spalte erstellt wurde. Wird sie durch den Benutzer erstellt, ist der Standardwert eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird die HeaderText -Eigenschaft auf einen neuen Wert festgelegt.

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

Hinweise

Die HeaderText -Eigenschaft wird in der Regel verwendet, um eine Beschriftung anzuzeigen, die MappingName sich vom Wert unterscheidet, wenn der MappingName Wert nicht leicht verständlich ist. Sie können z. B. in HeaderText "Vorname" ändern, wenn der MappingName Wert "FName" lautet.

Gilt für:

Freigeben über