DataGridTableStyle Klasse

Definition

public ref class DataGridTableStyle : System::ComponentModel::Component, System::Windows::Forms::IDataGridEditingService

public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

Vererbung

Object

MarshalByRefObject

Component

DataGridTableStyle

Implementiert

IDataGridEditingService

Beispiele

Im folgenden Codebeispiel werden zwei DataGridTableStyle Instanzen erstellt und die MappingName jedes -Objekts auf die TableName eines DataTable in festgelegt DataSet. Im Beispiel werden dann Objekte zu jedem GridColumnStylesCollectionDataGridTableStylehinzugefügtDataGridColumnStyle. Ein Beispiel, das ausgeführt wird, finden Sie im System.Windows.Forms.DataGrid Beispiel.

void AddCustomDataTableStyle()
{
   
   /* Create a new DataGridTableStyle and set
         its MappingName to the TableName of a DataTable. */
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   /* Add a GridColumnStyle and set its MappingName 
         to the name of a DataColumn in the DataTable. 
         Set the HeaderText and Width properties. */
   DataGridColumnStyle^ boolCol = gcnew DataGridBoolColumn;
   boolCol->MappingName = "Current";
   boolCol->HeaderText = "IsCurrent Customer";
   boolCol->Width = 150;
   ts1->GridColumnStyles->Add( boolCol );
   
   // Add a second column style.
   DataGridColumnStyle^ TextCol = gcnew DataGridTextBoxColumn;
   TextCol->MappingName = "custName";
   TextCol->HeaderText = "Customer Name";
   TextCol->Width = 250;
   ts1->GridColumnStyles->Add( TextCol );
   
   // Create the second table style with columns.
   DataGridTableStyle^ ts2 = gcnew DataGridTableStyle;
   ts2->MappingName = "Orders";
   
   // Change the colors.
   ts2->ForeColor = Color::Yellow;
   ts2->AlternatingBackColor = Color::Blue;
   ts2->BackColor = Color::Blue;
   
   // Create new DataGridColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   PropertyDescriptorCollection^ pcol = this->BindingContext[ myDataSet,"Customers.custToOrders" ]->GetItemProperties();
   DataGridColumnStyle^ csOrderAmount = gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   // Add the DataGridTableStyle objects to the collection.
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}

private void AddCustomDataTableStyle()
   {
      /* Create a new DataGridTableStyle and set
      its MappingName to the TableName of a DataTable. */
      DataGridTableStyle ts1 = new DataGridTableStyle();
      ts1.MappingName = "Customers";

      /* Add a GridColumnStyle and set its MappingName 
      to the name of a DataColumn in the DataTable. 
      Set the HeaderText and Width properties. */
      
      DataGridColumnStyle boolCol = new DataGridBoolColumn();
      boolCol.MappingName = "Current";
      boolCol.HeaderText = "IsCurrent Customer";
      boolCol.Width = 150;
      ts1.GridColumnStyles.Add(boolCol);
      
      // Add a second column style.
      DataGridColumnStyle TextCol = new DataGridTextBoxColumn();
      TextCol.MappingName = "custName";
      TextCol.HeaderText = "Customer Name";
      TextCol.Width = 250;
      ts1.GridColumnStyles.Add(TextCol);

      // Create the second table style with columns.
      DataGridTableStyle ts2 = new DataGridTableStyle();
      ts2.MappingName = "Orders";
      // Change the colors.
      ts2.ForeColor = Color.Yellow;
      ts2.AlternatingBackColor = Color.Blue;
      ts2.BackColor = Color.Blue;
      
      // Create new DataGridColumnStyle objects.
      DataGridColumnStyle cOrderDate = 
      new DataGridTextBoxColumn();
      cOrderDate.MappingName = "OrderDate";
      cOrderDate.HeaderText = "Order Date";
      cOrderDate.Width = 100;
      ts2.GridColumnStyles.Add(cOrderDate);

      PropertyDescriptorCollection pcol = this.BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();
      
      DataGridColumnStyle csOrderAmount = 
      new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
      csOrderAmount.MappingName = "OrderAmount";
      csOrderAmount.HeaderText = "Total";
      csOrderAmount.Width = 100;
      ts2.GridColumnStyles.Add(csOrderAmount);

      // Add the DataGridTableStyle objects to the collection.
      myDataGrid.TableStyles.Add(ts1);
      myDataGrid.TableStyles.Add(ts2);
   }

Private Sub AddCustomDataTableStyle()
    ' Create a new DataGridTableStyle and set
    ' its MappingName to the TableName of a DataTable. 
    Dim ts1 As New DataGridTableStyle()
    ts1.MappingName = "Customers"
    
    ' Add a GridColumnStyle and set its MappingName
    ' to the name of a DataColumn in the DataTable.
    ' Set the HeaderText and Width properties. 
    
    Dim boolCol As New DataGridBoolColumn()
    boolCol.MappingName = "Current"
    boolCol.HeaderText = "IsCurrent Customer"
    boolCol.Width = 150
    ts1.GridColumnStyles.Add(boolCol)
    
    ' Add a second column style.
    Dim TextCol As New DataGridTextBoxColumn()
    TextCol.MappingName = "custName"
    TextCol.HeaderText = "Customer Name"
    TextCol.Width = 250
    ts1.GridColumnStyles.Add(TextCol)

    ' Create the second table style with columns.
    Dim ts2 As New DataGridTableStyle()
    ts2.MappingName = "Orders"

    ' Change the colors.
    ts2.ForeColor = Color.Yellow
    ts2.AlternatingBackColor = Color.Blue
    ts2.BackColor = Color.Blue
    
    ' Create new DataGridColumnStyle objects.
    Dim cOrderDate As New DataGridTextBoxColumn()
    cOrderDate.MappingName = "OrderDate"
    cOrderDate.HeaderText = "Order Date"
    cOrderDate.Width = 100
    ts2.GridColumnStyles.Add(cOrderDate)
    
    Dim pcol As PropertyDescriptorCollection = Me.BindingContext(myDataSet, "Customers.custToOrders").GetItemProperties()
    
    Dim csOrderAmount As New DataGridTextBoxColumn(pcol("OrderAmount"), "c", True)
    csOrderAmount.MappingName = "OrderAmount"
    csOrderAmount.HeaderText = "Total"
    csOrderAmount.Width = 100
    ts2.GridColumnStyles.Add(csOrderAmount)

    ' Add the DataGridTableStyle objects to the collection.
    myDataGrid.TableStyles.Add(ts1)
    myDataGrid.TableStyles.Add(ts2)
End Sub

Hinweise

Das System.Windows.Forms.DataGrid Steuerelement zeigt Daten in Form eines Rasters an. Ist DataGridTableStyle eine Klasse, die nur das gezeichnete Raster darstellt. Dieses Raster sollte nicht mit der DataTable -Klasse verwechselt werden, die eine mögliche Datenquelle für das Raster darstellt. Stattdessen stellt die DataGridTableStyle streng das Raster dar, wie es im -Steuerelement dargestellt wird. Daher können Sie über die DataGridTableStyle die Darstellung des Rasters für jeden DataTablesteuern. Um anzugeben, welche DataGridTableStyle beim Anzeigen von Daten aus einem bestimmten DataTableverwendet wird, legen Sie die MappingName auf TableName ein DataTablefest.

Die GridTableStylesCollection über die TableStyles -Eigenschaft abgerufene enthält alle objekte, die DataGridTableStyle von einem System.Windows.Forms.DataGrid -Steuerelement verwendet werden. Die Auflistung kann so viele DataGridTableStyle Objekte enthalten, wie Sie benötigen, aber die MappingName von jedem muss eindeutig sein. Dadurch können Sie zur Laufzeit je nach Vorliebe des Benutzers eine andere DataGridTableStyle durch dieselben Daten ersetzen. Dazu ist Folgendes erforderlich:

1. Füllen Sie die GridTableStylesCollection mit DataGridTableStyle -Objekten auf. Wenn ein DataGridTableStyle in vorhanden GridTableStylesCollection ist, dessen MappingName Eigenschaftswert der DataTable -Eigenschaft des TableName -Objekts entspricht, wird mit DataTable dieser DataGridTableStyleangezeigt. Wenn keine DataGridTableStyle mit einem übereinstimmenden MappingNamevorhanden ist, wird die DataTable mit der Standardformatvorlage für Datenrastertabellen angezeigt.

2. Wenn ein anderes Rasterformat benötigt wird, verwenden Sie die Item -Eigenschaft, um das entsprechende DataGridTableStyle auszuwählen (übergeben Sie die TableName an die Item[] -Eigenschaft), und legen Sie den MappingName des zurückgegebenen Objekts auf einen neuen Wert fest.

3. Verwenden Sie die Item[] -Eigenschaft, um den gewünschten DataGridTableStyleauszuwählen, und legen Sie dessen MappingName auf den TableName von DataTablefest.

Um zu bestimmen, welche DataGridTableStyle derzeit angezeigt wird, verwenden Sie die DataSource Eigenschaften und DataMember von System.Windows.Forms.DataGrid , um einen CurrencyManagerzurückzugeben. Wenn die Datenquelle die ITypedList Schnittstelle implementiert, können Sie die GetListName -Methode verwenden, um die MappingName der aktuellen Tabelle zurückzugeben. Dies wird im folgenden C#-Code gezeigt:

private void PrintCurrentListName(DataGrid myDataGrid){  
 CurrencyManager myCM = (CurrencyManager)  
 BindingContext[myDataGrid.DataSource, myDataGrid.DataMember];  
 IList myList = myCM.List;  
 ITypedList thisList = (ITypedList) myList;  
 Console.WriteLine(thisList.GetListName(null));  
}  

Wenn die Objekte enthältDataTable, die DataSet über DataRelation Objekte verknüpft sind, und die derzeit angezeigte DataTable eine untergeordnete Tabelle ist, gibt die DataMember eine Zeichenfolge in Form von TableName.RelationName zurück (im einfachsten Fall). Wenn sich der DataTable in der Hierarchie weiter unten befindet, besteht die Zeichenfolge aus dem Namen der übergeordneten Tabelle gefolgt von den erforderlichen RelationName Werten, die erforderlich sind, um die Ebene der Tabelle zu erreichen. Stellen Sie sich beispielsweise drei DataTable Objekte in einer hierarchischen Beziehung mit dem Namen (oben nach unten) Regionsvor, Customersund Orderszwei DataRelation Objekte mit dem Namen RegionsToCustomers und CustomersToOrders, die Eigenschaft DataMember gibt "Regions.RegionsToCustomers.CustomersToOrders" zurück. Der MappingName lautet dann jedoch "Bestellungen".

Die Auflistung der DataGridTableStyle -Objekte wird über die TableStyles -Eigenschaft von System.Windows.Forms.DataGridzurückgegeben.

Wenn ein DataGridTableStyle angezeigt wird, überschreiben die Einstellungen für das DataGridTableStyle Steuerelement.System.Windows.Forms.DataGrid Wenn kein Wert für eine bestimmte DataGridTableStyle Eigenschaft festgelegt ist, wird stattdessen der System.Windows.Forms.DataGrid Wert des Steuerelements verwendet. Die folgende Liste zeigt die Eigenschaften, die DataGridColumnStyle festgelegt werden können, um Steuerelementeigenschaften außer Kraft zu setzen System.Windows.Forms.DataGrid :

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Um das DataGrid Objekt an ein stark typisiertes Array von Objekten zu binden, muss der Objekttyp öffentliche Eigenschaften enthalten. Um ein DataGridTableStyle zu erstellen, das das Array anzeigt, legen Sie die DataGridTableStyle.MappingName -Eigenschaft auf typename fest, wobei typename durch den Namen des Objekttyps ersetzt wird. Beachten Sie außerdem, dass bei der Eigenschaft die MappingName Groß-/Kleinschreibung beachtet wird. Der Typname muss genau übereinstimmen. Ein Beispiel finden Sie in der MappingName -Eigenschaft.

Sie können den DataGrid auch an einen ArrayListbinden. Ein Feature von ArrayList ist, dass es Objekte mit mehreren Typen enthalten kann, aber nur DataGrid dann an eine solche Liste gebunden werden kann, wenn alle Elemente in der Liste vom gleichen Typ wie das erste Element sind. Dies bedeutet, dass alle Objekte entweder vom gleichen Typ sein müssen oder von derselben Klasse wie das erste Element in der Liste erben müssen. Wenn das erste Element in einer Liste beispielsweise ein Controlist, könnte das zweite Element ein TextBox sein (das von Controlerbt). Wenn das erste Element hingegen ein TextBoxist, kann das zweite Objekt kein sein Control. Darüber hinaus müssen Elemente ArrayList enthalten sein, wenn sie gebunden sind, und die Objekte in der DataGridTableStyle müssen öffentliche Eigenschaften enthalten. Ein leeres ArrayList Raster führt zu einem leeren Raster. Legen Sie beim MappingNameDataGridTableStyle Binden an einen ArrayListvon auf "ArrayList" (den Typnamen) fest.

Konstruktoren

Felder

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection