DataGrid.TableStyles Eigenschaft

Definition

Ruft die Auflistung der DataGridTableStyle-Objekte für das Datenblatt ab.Gets the collection of DataGridTableStyle objects for the grid.

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.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Beispiele

Im folgenden Codebeispiel wird eine DataGridTableStyle für jede DataTable in einem DataSet erstellt und der MappingName des DataGridTableStyle auf den TableName des DataTable festgelegt.The following code example creates one DataGridTableStyle for each DataTable found in a DataSet, and sets the MappingName of the DataGridTableStyle to the TableName of the DataTable. Der DataGridTableStyle wird dann der von der TableStyles-Eigenschaft zurückgegebenen GridTableStylesCollection hinzugefügt.The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. Im Beispiel wird auch die MappingName der einzelnen DataGridColumnStyle in der GridColumnStylesCollection ausgegeben, die von der GridColumnStyles-Eigenschaft der einzelnen DataGridTableStyle in der GridTableStylesCollection zurückgegeben werden.The example also prints the MappingName of each DataGridColumnStyle in the GridColumnStylesCollection returned by the GridColumnStyles property of each DataGridTableStyle in the 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 den GridTableStylesCollection, der über die Eigenschaft TableStyles abgerufen wurde, um angepasste Ansichten jeder vom System.Windows.Forms.DataGrid-Steuerelement angezeigten Tabelle zu erstellen.Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

Standardmäßig enthält die von TableStyles-Eigenschaft zurückgegebene Auflistung keine DataGridTableStyle-Objekte.By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. So erstellen Sie einen Satz angepasster Ansichten:To create a set of customized views:

  1. Erstellen Sie eine DataGridTableStyle.Create a DataGridTableStyle.

  2. Legen Sie den MappingName des Raster Tabellenobjekts auf den TableName der DataTable fest.Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Fügen Sie dem von der GridColumnStyles-Eigenschaft zurückgegebenen GridColumnStylesCollection DataGridColumnStyle-Objekte hinzu, jeweils eine für jede Raster Spalte, die Sie anzeigen möchten.Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Legen Sie die MappingName der einzelnen DataGridColumnStyle auf die ColumnName einer DataColumn fest.Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Fügen Sie das DataGridTableStyle-Objekt der Auflistung hinzu, die von TableStyles-Eigenschaft zurückgegeben wird.Add the DataGridTableStyle object to the collection returned by TableStyles property.

Achtung

Erstellen Sie immer DataGridColumnStyle-Objekte, und fügen Sie Sie der GridColumnStylesCollection hinzu, bevor Sie dem GridTableStylesCollection DataGridTableStyle-Objekte hinzufügen.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Wenn Sie der Auflistung ein leeres DataGridTableStyle mit einem gültigen MappingName-Wert hinzufügen, werden automatisch DataGridColumnStyle-Objekte für Sie generiert.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Folglich wird eine Ausnahme ausgelöst, wenn Sie versuchen, dem GridColumnStylesCollection neue DataGridColumnStyle-Objekte mit doppelten MappingName-Werten hinzuzufügen.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

Gilt für:

Siehe auch