DataGridTableStyle Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

DataGridTableStyle

Kenmerken

BrowsableAttribute ObsoleteAttribute

Implementeringen

IDataGridEditingService

Voorbeelden

In het volgende codevoorbeeld worden twee DataGridTableStyle exemplaren gemaakt en wordt het MappingName object ingesteld op een TableNameDataTable in een DataSetobject. In het voorbeeld worden DataGridColumnStyle vervolgens objecten toegevoegd aan elk GridColumnStylesCollectionDataGridTableStyle object. Zie het voorbeeld System.Windows.Forms.DataGrid voor een voorbeeld dat wordt uitgevoerd.

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

Opmerkingen

Het besturingselement System.Windows.Forms.DataGrid geeft gegevens weer in de vorm van een raster. Dit DataGridTableStyle is een klasse die alleen het getekende raster vertegenwoordigt. Dit raster mag niet worden verward met de DataTable klasse, een mogelijke gegevensbron voor het raster. In plaats daarvan vertegenwoordigt het strikt het DataGridTableStyle raster zoals het in de controle wordt geschilderd. Daarom kunt u het DataGridTableStyle uiterlijk van het raster voor elk DataTableraster bepalen. Als u wilt opgeven welke DataGridTableStyle gegevens worden gebruikt bij het weergeven van gegevens van een bepaalde DataTable, stelt u de MappingName waarde in op de TableName waarde van een DataTable.

De eigenschap GridTableStylesCollection opgehaald via de eigenschap TableStyles bevat alle DataGridTableStyle objecten die worden gebruikt door een besturingselement System.Windows.Forms.DataGrid. De verzameling kan zoveel DataGridTableStyle objecten bevatten als u nodig hebt, maar de MappingName verzameling moet uniek zijn. Tijdens runtime kunt u hiermee een andere DataGridTableStyle gegevens vervangen, afhankelijk van de voorkeur van de gebruiker. Dit doet u als volgt:

1. Vul de GridTableStylesCollection objecten in DataGridTableStyle . Als er een DataGridTableStyle bestaat in de GridTableStylesCollection eigenschapswaarde waarvan MappingName de eigenschap gelijk is aan de eigenschap van DataTable het TableName object, wordt deze DataTable weergegeven met deze DataGridTableStylewaarde. Als er geen DataGridTableStyle bestaat met een overeenkomende MappingNamewaarde, wordt deze DataTable weergegeven met de standaardstijl voor gegevensrastertabellen.

2. Wanneer u een andere rasterstijl nodig hebt, gebruikt u de Item eigenschap om de juiste DataGridTableStyle eigenschap te selecteren (geef de TableName eigenschap door aan de Item[] eigenschap) en stelt u het MappingName geretourneerde object in op een nieuwe waarde.

3. Gebruik de Item[] eigenschap om de gewenste DataGridTableStyleeigenschap te selecteren en de eigenschap MappingName in te stellen op de TableNameDataTable.

Als u wilt bepalen welke DataGridTableStyle momenteel wordt weergegeven, gebruikt u de eigenschappen DataSource en DataMember van de System.Windows.Forms.DataGrid om een CurrencyManager te retourneren. Als de gegevensbron de ITypedList interface implementeert, kunt u de GetListName methode gebruiken om de MappingName huidige tabel te retourneren. Dit wordt weergegeven in de onderstaande C#-code:

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

Als de DataSet objecten gerelateerd zijn DataTable aan DataRelation objecten en de weergegeven DataTable tabel een onderliggende tabel is, retourneert de DataMember tekenreeks in de vorm van TableName.RelationName (in het eenvoudigste geval). Als de DataTable waarde verder omlaag in de hiërarchie ligt, bestaat de tekenreeks uit de naam van de bovenliggende tabel, gevolgd door de benodigde RelationName waarden om het niveau van de tabel te bereiken. Stel bijvoorbeeld dat drie DataTable objecten in een hiërarchische relatie met de naam (boven naar beneden) Regionsen Customers, en Orderstwee DataRelation objecten met de naam RegionsToCustomers en CustomersToOrdersde DataMember eigenschap 'Regions.RegionsToCustomers.CustomersToOrders' retourneren. MappingName De naam is echter 'Orders'.

De verzameling van DataGridTableStyle-objecten wordt geretourneerd via de eigenschap TableStyles van de System.Windows.Forms.DataGrid.

Wanneer een DataGridTableStyle wordt weergegeven, overschrijft de instellingen voor de DataGridTableStyle de instellingen voor het besturingselement System.Windows.Forms.DataGrid. Als een waarde niet is ingesteld voor een bepaalde eigenschap DataGridTableStyle, wordt de waarde van het besturingselement System.Windows.Forms.DataGrid gebruikt. De volgende lijst bevat de eigenschappen DataGridColumnStyle die kunnen worden ingesteld om System.Windows.Forms.DataGrid eigenschappen van het besturingselement te overschrijven:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Als u de DataGrid aan een sterk getypte matrix van objecten wilt binden, moet het objecttype openbare eigenschappen bevatten. Als u een DataGridTableStyle matrix wilt maken die de matrix weergeeft, stelt u de DataGridTableStyle.MappingName eigenschap in op typename waar typename deze wordt vervangen door de naam van het objecttype. Houd er ook rekening mee dat de MappingName eigenschap hoofdlettergevoelig is. De naam van het type moet exact overeenkomen. Zie de MappingName eigenschap voor een voorbeeld.

U kunt de DataGrid aan een ArrayList. Een kenmerk van de ArrayList functie is dat het objecten van meerdere typen kan bevatten, maar de DataGrid functie kan alleen worden gebonden aan een dergelijke lijst wanneer alle items in de lijst van hetzelfde type zijn als het eerste item. Dit betekent dat alle objecten van hetzelfde type moeten zijn of dat ze moeten overnemen van dezelfde klasse als het eerste item in de lijst. Als het eerste item in een lijst bijvoorbeeld een Controlis, kan het tweede item een TextBox item zijn (dat overgaat van Control). Als het eerste item daarentegen een TextBoxis, kan het tweede object geen Control. Verder moet het ArrayList item items bevatten wanneer deze is gebonden en moeten de objecten in de DataGridTableStyle objecten openbare eigenschappen bevatten. Een lege ArrayList waarde resulteert in een leeg raster. Wanneer u een binding tot een ArrayListwaarde instelt, stelt u de MappingNameDataGridTableStyle waarde in op 'ArrayList' (de naam van het type).

Zie ook

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection