DataGridTableStyle Classe

Définition

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

Héritage

Object

MarshalByRefObject

Component

DataGridTableStyle

Implémente

IDataGridEditingService

Exemples

L’exemple de code suivant crée deux DataGridTableStyle instances et définit le MappingName de chaque objet sur le TableName d’un DataTable dans un DataSet. L’exemple ajoute DataGridColumnStyle ensuite des GridColumnStylesCollection objets au de chaque DataGridTableStyle. Pour obtenir un exemple qui s’exécute, consultez l’exemple System.Windows.Forms.DataGrid .

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

Remarques

Le System.Windows.Forms.DataGrid contrôle affiche les données sous la forme d’une grille. est DataGridTableStyle une classe qui représente uniquement la grille dessinée. Cette grille ne doit pas être confondue avec la DataTable classe , qui est une source possible de données pour la grille. Au lieu de cela, le DataGridTableStyle représente strictement la grille telle qu’elle est peinte dans le contrôle. Par conséquent, par le biais du DataGridTableStyle , vous pouvez contrôler l’apparence de la grille pour chaque DataTable. Pour spécifier lequel DataGridTableStyle est utilisé lors de l’affichage des données d’un particulier DataTable, définissez sur MappingName le TableName d’un DataTable.

Récupéré GridTableStylesCollection via la TableStyles propriété contient tous les DataGridTableStyle objets utilisés par un System.Windows.Forms.DataGrid contrôle. La collection peut contenir autant d’objets DataGridTableStyle que nécessaire, mais le MappingName de chacun doit être unique. Au moment de l’exécution, cela vous permet de remplacer une autre DataGridTableStyle par les mêmes données, en fonction de la préférence de l’utilisateur. Pour ce faire :

1. Remplissez le avec DataGridTableStyle des GridTableStylesCollection objets . S’il existe un DataGridTableStyle dans le dont MappingName la GridTableStylesCollection valeur de propriété est égale à la DataTable propriété de TableName l’objet, le DataTable est affiché avec ce DataGridTableStyle. S’il n’en existe aucun DataGridTableStyle avec une correspondance MappingName, est DataTable affiché avec le style par défaut pour les tables de grille de données.

2. Lorsqu’un autre style de grille est nécessaire, utilisez la Item propriété pour sélectionner le approprié DataGridTableStyle (passez le TableName à la Item[] propriété) et définissez le MappingName de l’objet retourné sur une nouvelle valeur.

3. Utilisez la Item[] propriété pour sélectionner le souhaité DataGridTableStyleet définissez-le MappingName sur le TableName du DataTable.

Pour déterminer lequel DataGridTableStyle est actuellement affiché, utilisez les DataSource propriétés et DataMember de pour System.Windows.Forms.DataGrid renvoyer un CurrencyManager. Si la source de données implémente l’interface ITypedList , vous pouvez utiliser la GetListName méthode pour retourner le MappingName de la table active. Cela est illustré dans le code C# ci-dessous :

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));  
}  

Si contient DataTable des DataSet objets liés par le biais DataRelation d’objets et que le actuellement affiché DataTable est une table enfant, retourne DataMember une chaîne sous la forme TableName.RelationName (dans le cas le plus simple). Si est DataTable plus bas dans la hiérarchie, la chaîne se compose du nom de la table parente suivi des valeurs nécessaires RelationName pour atteindre le niveau de la table. Par exemple, imaginez trois DataTable objets dans une relation hiérarchique nommée (de haut en bas) Regions, Customerset , et Ordersdeux DataRelation objets nommés RegionsToCustomers et CustomersToOrders, la DataMember propriété retourne « Regions.RegionsToCustomers.CustomersToOrders ». Toutefois, le MappingName sera alors « Orders ».

La collection d’objets DataGridTableStyle est retournée par le biais de la TableStyles propriété du System.Windows.Forms.DataGrid.

Lorsqu’un DataGridTableStyle est affiché, les paramètres de l’objet DataGridTableStyle remplacent les paramètres du System.Windows.Forms.DataGrid contrôle. Si aucune valeur n’est définie pour une propriété particulière DataGridTableStyle , la valeur du contrôle est utilisée à la System.Windows.Forms.DataGrid place. La liste suivante présente les DataGridColumnStyle propriétés qui peuvent être définies pour remplacer System.Windows.Forms.DataGrid les propriétés de contrôle :

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Pour lier à DataGrid un tableau d’objets fortement typé, le type d’objet doit contenir des propriétés publiques. Pour créer un DataGridTableStyle qui affiche le tableau, définissez la DataGridTableStyle.MappingName propriété sur typename où typename est remplacé par le nom du type d’objet. Notez également que la propriété respecte la MappingName casse ; le nom de type doit être mis en correspondance exactement. Consultez la MappingName propriété pour obtenir un exemple.

Vous pouvez également lier à DataGrid un ArrayList. Une fonctionnalité de est ArrayList qu’il peut contenir des objets de plusieurs types, mais ne DataGrid peut se lier à une telle liste que lorsque tous les éléments de la liste sont du même type que le premier élément. Cela signifie que tous les objets doivent être du même type ou hériter de la même classe que le premier élément de la liste. Par exemple, si le premier élément d’une liste est un Control, le deuxième élément peut être un TextBox (qui hérite de Control). Si, en revanche, le premier élément est un TextBox, le deuxième objet ne peut pas être un Control. En outre, le ArrayList doit contenir des éléments lorsqu’il est lié et les objets dans doivent DataGridTableStyle contenir des propriétés publiques. Un vide ArrayList génère une grille vide. Lors de la liaison à un ArrayList, définissez le MappingName de sur DataGridTableStyle « ArrayList » (le nom du type).

Constructeurs

Champs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection