DataGrid.TableStyles-Eigenschaft

Artikel
08/20/2007

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

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

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public ReadOnly Property TableStyles As GridTableStylesCollection
'Usage
Dim instance As DataGrid
Dim value As GridTableStylesCollection

value = instance.TableStyles

[LocalizableAttribute(true)] 
public GridTableStylesCollection TableStyles { get; }

[LocalizableAttribute(true)] 
public:
property GridTableStylesCollection^ TableStyles {
    GridTableStylesCollection^ get ();
}

/** @property */
public GridTableStylesCollection get_TableStyles ()

public function get TableStyles () : GridTableStylesCollection

Eigenschaftenwert

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

Hinweise

Mithilfe der GridTableStylesCollection, die über die TableStyles-Eigenschaft abgerufen wird, können Sie angepasste Ansichten der einzelnen Tabellen erstellen, die vom System.Windows.Forms.DataGrid-Steuerelement angezeigt werden.

Die von der TableStyles-Eigenschaft zurückgegebene Auflistung enthält standardmäßig keine DataGridTableStyle-Objekte. So erstellen Sie einen Satz angepasster Ansichten:

Erstellen Sie einen DataGridTableStyle.
Legen Sie den MappingName des Datenblatttabellenobjekts auf den TableName der DataTable fest.
Fügen Sie der von der GridColumnStyles-Eigenschaft zurückgegebenen GridColumnStylesCollection für jede Datenblattspalte, die angezeigt werden soll, jeweils ein DataGridColumnStyle-Objekt hinzu.
Legen Sie den MappingName der einzelnen DataGridColumnStyle auf den ColumnName einer DataColumn fest.
Fügen Sie das DataGridTableStyle-Objekt der Auflistung hinzu, die von der TableStyles-Eigenschaft zurückgegeben wird.

Warnung

Erstellen Sie vor dem Hinzufügen von DataGridTableStyle-Objekten zur GridTableStylesCollection immer DataGridColumnStyle-Objekte, und fügen Sie diese der GridColumnStylesCollection hinzu. Wenn Sie der Auflistung einen leeren DataGridTableStyle mit einem gültigen MappingName-Wert hinzufügen, werden automatisch DataGridColumnStyle-Objekte generiert. Folglich wird beim Versuch, der GridColumnStylesCollection neue DataGridColumnStyle-Objekte mit doppelten MappingName-Werten hinzuzufügen, eine Ausnahme ausgelöst.

Beispiel

Im folgenden Codebeispiel wird für jede in einem DataSet gefundene DataTable ein DataGridTableStyle erstellt und der MappingName des DataGridTableStyle auf den TableName der DataTable festgelegt. Anschließend wird der DataGridTableStyle der GridTableStylesCollection hinzugefügt, die von der TableStyles-Eigenschaft zurückgegeben wird. Darüber hinaus wird der MappingName der einzelnen DataGridColumnStyle-Objekte in der GridColumnStylesCollection ausgegeben, die von der GridColumnStyles-Eigenschaft der einzelnen DataGridTableStyle-Objekte in der GridTableStylesCollection zurückgegeben wird.

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

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:
   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)
{
    DataTable t;
    for (int iCtr = 0; iCtr < myDataSet.get_Tables().get_Count(); iCtr++) {
        t = myDataSet.get_Tables().get_Item(iCtr);
        DataGridTableStyle myGridTableStyle = new DataGridTableStyle();
        myGridTableStyle.set_MappingName(t.get_TableName());
        myDataGrid.get_TableStyles().Add(myGridTableStyle);
    }
} //AddTables

/*  Note that DataGridColumnStyle objects will
    be created automatically for the first DataGridTableStyle
    when you add it to the GridTableStylesCollection.
 */
private void PrintGridStyleInfo(DataGrid myDataGrid)
{
    DataGridTableStyle myGridStyle;
    for (int iCtr = 0; iCtr < myDataGrid.get_TableStyles().get_Count(); 
        iCtr++) {
        /*  Print the MappingName of each DataGridTableStyle,
            and the MappingName of each DataGridColumnStyle. 
         */
        myGridStyle = myDataGrid.get_TableStyles().get_Item(iCtr);
        Console.WriteLine(myGridStyle.get_MappingName());
        DataGridColumnStyle myColumnStyle;
        for (int iCtr1 = 0; 
            iCtr1 < myGridStyle.get_GridColumnStyles().get_Count();
            iCtr1++) {
            myColumnStyle = myGridStyle.get_GridColumnStyles().
                get_Item(iCtr1);
            Console.WriteLine(myColumnStyle.get_MappingName());
        }
    }
} //PrintGridStyleInfo

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

DataGrid-Klasse
DataGrid-Member
System.Windows.Forms-Namespace
DataColumn
DataTable
DataGridTableStyle
GridTableStylesCollection

Freigeben über