DataGridColumnStyle.HeaderText-Eigenschaft

Ruft den Text des Spaltenkopfs ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property HeaderText As String
'Usage
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)

Eigenschaftenwert

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 ("").

Hinweise

Die HeaderText-Eigenschaft wird i. d. R. verwendet, um eine andere Beschriftung als den MappingName-Wert anzuzeigen, wenn der MappingName-Wert nicht ohne Weiteres verständlich ist. Beispielsweise können Sie den HeaderText in "Vorname" ändern, wenn der MappingName-Wert "VName" ist.

Beispiel

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataGridColumnStyle-Klasse
DataGridColumnStyle-Member
System.Windows.Forms-Namespace
ColumnName
Caption