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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

Héritage

Object

MarshalByRefObject

Component

DataGridTableStyle

Attributs

BrowsableAttribute ObsoleteAttribute

Implémente

IDataGridEditingService

Exemples

L’exemple de code suivant crée deux DataGridTableStyle instances et définit l’objet MappingNameDataTable sur un TableName dans un DataSet. L’exemple ajoute ensuite des DataGridColumnStyle objets à chaque DataGridTableStyleGridColumnStylesCollection . 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. Il DataGridTableStyle s’agit d’une classe qui représente la grille dessinée uniquement. 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, la DataGridTableStyle grille représente strictement la grille telle qu’elle est peinte dans le contrôle. Par conséquent, par le biais de la DataGridTableStyle grille, vous pouvez contrôler l’apparence de la grille pour chaque DataTable. Pour spécifier ce qui DataGridTableStyle est utilisé lors de l’affichage des données d’un particulier DataTable, définissez la valeur MappingName sur l’objet TableNameDataTable.

La GridTableStylesCollection propriété récupérée TableStyles 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 chacune MappingName doit être unique. Au moment de l’exécution, cela vous permet de remplacer une autre DataGridTableStyle donnée pour les mêmes données, en fonction de la préférence de l’utilisateur. Pour ce faire :

1. Remplissez les GridTableStylesCollectionDataGridTableStyle objets. S’il existe dans DataGridTableStyle la valeur de propriété dont MappingName la GridTableStylesCollection valeur de propriété est égale à la propriété de TableName l’objetDataTable, l’objet DataTable est affiché avec ce DataGridTableStyle. S’il n’existe pas DataGridTableStyle avec une correspondance MappingName, il DataTable s’affiche 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 l’élément approprié DataGridTableStyle (passez-le TableName à la Item[] propriété) et définissez l’objet MappingName retourné sur une nouvelle valeur.

3. Utilisez la Item[] propriété pour sélectionner l’élément souhaitéDataGridTableStyle, puis définissez-la MappingName sur la DataTablepropriété TableName .

Pour déterminer qui DataGridTableStyle est actuellement affiché, utilisez les propriétés et DataMember les DataSource propriétés de l’objet System.Windows.Forms.DataGrid pour retourner un CurrencyManager. Si la source de données implémente l’interface ITypedList , vous pouvez utiliser la GetListName méthode pour retourner la MappingName table active. Ceci 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 les DataSet objets contiennent DataTable des objets associés par le biais DataRelation d’objets et que le tableau actuellement affiché DataTable est une table enfant, la DataMember chaîne retourne une chaîne sous la forme TableName.RelationName (dans le cas le plus simple). Si la DataTable valeur est plus bas dans la hiérarchie, la chaîne se compose du nom de la table parente suivie 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 (en haut en bas) Regions, Customerset Ordersdeux DataRelation objets nommés et deux objets nommés RegionsToCustomers et CustomersToOrders, la DataMember propriété retourne « Regions.RegionsToCustomers.CustomersToOrders ». Toutefois, il MappingName s’agira ensuite de « Commandes ».

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

Lorsqu’un DataGridTableStyle paramètre est affiché, les paramètres du DataGridTableStyle contrôle remplacent les paramètres du System.Windows.Forms.DataGrid contrôle. Si une valeur n’est pas définie pour une propriété particulière DataGridTableStyle , la System.Windows.Forms.DataGrid valeur du contrôle est utilisée à la place. La liste suivante montre les propriétés qui peuvent être définies pour remplacer System.Windows.Forms.DataGrid les DataGridColumnStyle 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 le DataGrid tableau d’objets fortement typé, le type d’objet doit contenir des propriétés publiques. Pour créer un DataGridTableStyle tableau qui affiche le tableau, définissez la DataGridTableStyle.MappingName propriété sur typename l’emplacement typename où est remplacée par le nom du type d’objet. Notez également que la propriété respecte la MappingName casse ; le nom du type doit être mis en correspondance exactement. Consultez la MappingName propriété pour obtenir un exemple.

Vous pouvez également lier le DataGrid fichier à un ArrayList. Une fonctionnalité du ArrayList type est qu’elle peut contenir des objets de plusieurs types, mais elle DataGrid ne peut être liée qu’à une telle liste 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, soit ils doivent 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, d’autre part, le premier élément est un TextBox, le deuxième objet ne peut pas être un Control. En outre, les ArrayList éléments doivent y figurer lorsqu’ils sont liés et les objets dans le DataGridTableStyle fichier doivent contenir des propriétés publiques. Une grille vide ArrayList entraîne une grille vide. Lors de la liaison à un ArrayList, définissez la MappingNameDataGridTableStyle valeur « ArrayList » (nom du type).

Voir aussi

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection