DataGridViewColumn.HeaderText Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Beschriftungstext für die Headerzelle der Spalte ab oder legt ihn fest.

public:
 property System::String ^ HeaderText { System::String ^ get(); void set(System::String ^ value); };

public string HeaderText { get; set; }

member this.HeaderText : string with get, set

Public Property HeaderText As String

Eigenschaftswert

String

Ein String mit dem gewünschten Text. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird die HeaderText -Eigenschaft verwendet, um den Text in der Spaltenüberschrift zu ändern. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn-Klasse bereitgestellt wird.

// Change the text in the column header.
void Button9_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   IEnumerator^ myEnum2 = dataGridView->Columns->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum2->Current);
      column->HeaderText = String::Concat( L"Column ", column->Index.ToString() );
   }
}

// Change the text in the column header.
private void Button9_Click(object sender,
    EventArgs args)
{
    foreach (DataGridViewColumn column in dataGridView.Columns)
    {

        column.HeaderText = String.Concat("Column ",
            column.Index.ToString());
    }
}

' Change the text in the column header.
Private Sub Button9_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button9.Click

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderText = String.Concat("Column ", _
            column.Index.ToString)
    Next
End Sub

Hinweise

Diese Eigenschaft ist nur nützlich, wenn die Spalte über eine zugeordnete Headerzelle verfügt. Weitere Informationen finden Sie in den Ausführungen zur HeaderCellCore-Eigenschaft.

Hinweis

Es gibt keine entsprechende Headertexteigenschaft für Zeilen. Um Bezeichnungen in Zeilenüberschriften anzuzeigen, müssen Sie das DataGridView.CellPainting Ereignis behandeln und Ihre eigenen Beschriftungen zeichnen, wenn DataGridViewCellPaintingEventArgs.ColumnIndex -1 ist.

Weitere Informationen

• DataGridView
• HeaderCellCore