DataGrid.TableStyles Eigenschaft

Definition

Ruft die Auflistung der DataGridTableStyle-Objekte für das Datenblatt ab.

public:
 property System::Windows::Forms::GridTableStylesCollection ^ TableStyles { System::Windows::Forms::GridTableStylesCollection ^ get(); };
public System.Windows.Forms.GridTableStylesCollection TableStyles { get; }
member this.TableStyles : System.Windows.Forms.GridTableStylesCollection
Public ReadOnly Property TableStyles As GridTableStylesCollection

Eigenschaftswert

Eine GridTableStylesCollection, die die Auflistung der DataGridTableStyle-Objekte darstellt.

Beispiele

Im folgenden Codebeispiel wird eins DataGridTableStyle für jede DataTable in einem DataSeterstellt, und legt den MappingName von DataGridTableStyle auf den TableName fest DataTable. Der DataGridTableStyle wird dann dem von der GridTableStylesCollectionTableStyles -Eigenschaft zurückgegebenen hinzugefügt. Das Beispiel gibt auch die MappingName der einzelnen DataGridColumnStyle in der GridColumnStylesCollection von der GridColumnStyles -Eigenschaft zurückgegebenen in DataGridTableStyle aus GridTableStylesCollection.

private:
   void AddTables( DataGrid^ myDataGrid, DataSet^ myDataSet )
   {
      for each ( DataTable^ t in myDataSet->Tables )
      {
         DataGridTableStyle^ myGridTableStyle =
            gcnew DataGridTableStyle;
         myGridTableStyle->MappingName = t->TableName;
         myDataGrid->TableStyles->Add( myGridTableStyle );
         
         /* Note that DataGridColumnStyle objects will
            be created automatically for the first DataGridTableStyle
            when you add it to the GridTableStylesCollection.*/
      }
   }

   void PrintGridStyleInfo( DataGrid^ myDataGrid )
   {
      /* Print the MappingName of each DataGridTableStyle,
         and the MappingName of each DataGridColumnStyle. */
      for each ( DataGridTableStyle^ myGridStyle in
         myDataGrid->TableStyles )
      {
         Console::WriteLine( myGridStyle->MappingName );
         for each ( DataGridColumnStyle^ myColumnStyle in
            myGridStyle->GridColumnStyles )
         {
            Console::WriteLine( myColumnStyle->MappingName );
         }
      }
   }
private void AddTables(DataGrid myDataGrid, DataSet myDataSet){
   foreach(DataTable t in myDataSet.Tables){
      DataGridTableStyle myGridTableStyle = new 
      DataGridTableStyle();
      myGridTableStyle.MappingName = t.TableName;
      myDataGrid.TableStyles.Add(myGridTableStyle);

      /* Note that DataGridColumnStyle objects will
      be created automatically for the first DataGridTableStyle
      when you add it to the GridTableStylesCollection.*/
   }
}
private void PrintGridStyleInfo(DataGrid myDataGrid){
   /* Print the MappingName of each DataGridTableStyle,
   and the MappingName of each DataGridColumnStyle. */
   foreach(DataGridTableStyle myGridStyle in 
   myDataGrid.TableStyles){
   Console.WriteLine(myGridStyle.MappingName);
   foreach(DataGridColumnStyle myColumnStyle in 
      myGridStyle.GridColumnStyles){
  Console.WriteLine(myColumnStyle.MappingName);
      }
   }
}
Private Sub AddTables(myDataGrid As DataGrid, _
myDataSet As DataSet )
    Dim t As DataTable 
    For Each t in myDataSet.Tables
       Dim myGridTableStyle As DataGridTableStyle  = new _
       DataGridTableStyle()
       myGridTableStyle.MappingName = t.TableName
       myDataGrid.TableStyles.Add(myGridTableStyle)
       ' Note that DataGridColumnStyle objects will
       ' be created automatically for the first DataGridTableStyle
       ' when you add it to the GridTableStylesCollection.*/
    Next
 End Sub
 Private Sub PrintGridStyleInfo(myDataGrid As DataGrid )
    Dim myGridStyle As DataGridTableStyle
    Dim myColumnStyle As DataGridColumnStyle
    
    for each myGridStyle in _
    myDataGrid.TableStyles
       Console.WriteLine(myGridStyle.MappingName)
       for each myColumnStyle in myGridStyle.GridColumnStyles
      Console.WriteLine(myColumnStyle.MappingName)
       Next
    Next
 End Sub

Hinweise

Verwenden Sie die GridTableStylesCollection über die TableStyles -Eigenschaft abgerufene, um benutzerdefinierte Ansichten jeder vom System.Windows.Forms.DataGrid Steuerelement angezeigten Tabelle zu erstellen.

Standardmäßig enthält die von TableStyles zurückgegebene Auflistung keine DataGridTableStyle Objekte. So erstellen Sie eine Reihe benutzerdefinierter Ansichten:

  1. Erstellen Sie eine DataGridTableStyle.

  2. Legen Sie das MappingName des Rastertabellenobjekts auf das TableName von DataTablefest.

  3. Fügen Sie DataGridColumnStyle Objekte hinzu, eins für jede Rasterspalte, die GridColumnStylesCollection Sie anzeigen möchten, dem von der GridColumnStyles -Eigenschaft zurückgegebenen.

  4. Legen Sie die MappingName von jedem DataGridColumnStyle auf den ColumnName von fest DataColumn.

  5. Fügen Sie das DataGridTableStyle -Objekt der Von-Eigenschaft zurückgegebenen TableStyles Auflistung hinzu.

Achtung

Erstellen DataGridColumnStyle Sie immer Objekte, und fügen Sie sie dem GridColumnStylesCollection hinzu, bevor Sie DataGridTableStyle Objekte hinzufügen GridTableStylesCollection. Wenn Sie der Auflistung einen leeren DataGridTableStyle Wert mit einem gültigen MappingName Wert hinzufügen, DataGridColumnStyle werden Objekte automatisch für Sie generiert. Folglich wird eine Ausnahme ausgelöst, wenn Sie versuchen, neue DataGridColumnStyle Objekte mit doppelten MappingName Werten zu GridColumnStylesCollectionhinzufügen.

Gilt für:

Weitere Informationen