DataGridViewColumn.HeaderText Eigenschaft

Definition

Ruft den Beschriftungstext für die Headerzelle der Spalte ab oder legt ihn fest.Gets or sets the caption text on the column's header cell.

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

Ein String mit dem gewünschten Text.A String with the desired text. Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Beispiele

Im folgenden Codebeispiel wird die HeaderText-Eigenschaft verwendet, um den Text in der Spaltenüberschrift zu ändern.The following code example uses the HeaderText property to change the text in the column header. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn-Klasse bereitgestellt wird.This code example is part of a larger example provided for the DataGridViewColumn class.

// 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 der Spalte eine Header Zelle zugeordnet ist.This property is useful only when the column has an associated header cell. Weitere Informationen finden Sie unter den Ausführungen zur Eigenschaft HeaderCellCore.For more information, see the HeaderCellCore property.

Hinweis

Es ist keine entsprechende Header Text Eigenschaft für Zeilen vorhanden.There is no corresponding header text property for rows. Um Bezeichnungen in Zeilen Headern anzuzeigen, müssen Sie das DataGridView.CellPainting-Ereignis behandeln und ihre eigenen Bezeichnungen zeichnen, wenn DataGridViewCellPaintingEventArgs.ColumnIndex den Wert-1 hat.To display labels in row headers, you must handle the DataGridView.CellPainting event and paint your own labels when DataGridViewCellPaintingEventArgs.ColumnIndex is -1.

Gilt für:

Siehe auch