DataGrid.TableStyles Propriété

Définition

Obtient la collection des objets DataGridTableStyle pour la grille.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

Valeur de propriété

GridTableStylesCollection représentant la collection des objets DataGridTableStyle.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Exemples

L’exemple de code suivant crée un DataGridTableStyle pour chaque DataTable trouvée dans un DataSet, et définit le MappingName du DataGridTableStyle sur le TableName du DataTable.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. Le DataGridTableStyle est ensuite ajouté à la GridTableStylesCollection retournée par la propriété TableStyles.The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. L’exemple imprime également le MappingName de chaque DataGridColumnStyle dans le GridColumnStylesCollection retourné par la propriété GridColumnStyles de chaque DataGridTableStyle dans le GridTableStylesCollection.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    

Remarques

Utilisez le GridTableStylesCollection récupéré via la propriété TableStyles pour créer des vues personnalisées de chaque table affichée par le contrôle System.Windows.Forms.DataGrid.Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

Par défaut, la collection retournée par la propriété TableStyles ne contient aucun objet DataGridTableStyle.By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. Pour créer un ensemble de vues personnalisées :To create a set of customized views:

  1. Créer un DataGridTableStyle.Create a DataGridTableStyle.

  2. Définissez le MappingName de l’objet table de la grille sur la TableName du DataTable.Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Ajoutez des objets DataGridColumnStyle, un pour chaque colonne de grille que vous souhaitez afficher, à la GridColumnStylesCollection retournée par la propriété GridColumnStyles.Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Définissez le MappingName de chaque DataGridColumnStyle sur le ColumnName d’un DataColumn.Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Ajoutez l’objet DataGridTableStyle à la collection retournée par la propriété TableStyles.Add the DataGridTableStyle object to the collection returned by TableStyles property.

Attention

Créez toujours les objets DataGridColumnStyle et ajoutez-les au GridColumnStylesCollection avant d’ajouter DataGridTableStyle objets au GridTableStylesCollection.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Lorsque vous ajoutez un @no__t vide-0 avec une valeur MappingName valide à la collection, DataGridColumnStyle objets sont générés automatiquement pour vous.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Par conséquent, une exception est levée si vous essayez d’ajouter de nouveaux objets DataGridColumnStyle avec des valeurs MappingName en double au GridColumnStylesCollection.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

S’applique à

Voir aussi