DataGridTableStyle Sınıf

Tanım

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

Devralma

Object

MarshalByRefObject

Component

DataGridTableStyle

Uygulamalar

IDataGridEditingService

Örnekler

Aşağıdaki kod örneği iki DataGridTableStyle örnek oluşturur ve içindeki her nesnenin TableNameDataTableDataSetdeğerini olarak ayarlar.MappingName Örnek daha sonra her DataGridTableStyleöğesine nesneleri GridColumnStylesCollection eklerDataGridColumnStyle. Çalışan bir örnek için örne System.Windows.Forms.DataGrid bakın.

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

Açıklamalar

Denetim verileri System.Windows.Forms.DataGrid kılavuz biçiminde görüntüler. DataGridTableStyle yalnızca çizilmiş kılavuzu temsil eden bir sınıftır. Bu kılavuz, kılavuz için olası bir veri kaynağı olan sınıfıyla DataTable karıştırılmamalıdır. Bunun yerine, DataGridTableStyle denetimde boyandıkça kılavuzu kesinlikle temsil eder. Bu nedenle, aracılığıyla DataGridTableStyle her DataTableiçin kılavuzun görünümünü denetleyebilirsiniz. Belirli bir öğesinin verilerini görüntülerken hangilerinin DataGridTableStyle kullanılacağını belirtmek için TableNameDataTabledeğerini olarak ayarlayınMappingName.DataTable

GridTableStylesCollection özelliği aracılığıyla TableStyles alınan, bir System.Windows.Forms.DataGrid denetim tarafından kullanılan tüm DataGridTableStyle nesneleri içerir. Koleksiyon ihtiyacınız olan sayıda DataGridTableStyle nesne içerebilir, ancak MappingName her birinin benzersiz olması gerekir. Çalışma zamanında bu, kullanıcının tercihine bağlı olarak aynı veriler için farklı DataGridTableStyle bir değer kullanmanıza olanak tanır. Bunu yapmak için:

1. GridTableStylesCollection öğesini nesnelerle DataGridTableStyle doldurun. özellik değeri nesnenin özelliğine eşit olan MappingName içinde bir DataGridTableStyle varsa, DataTable ile görüntülenirDataGridTableStyle.GridTableStylesCollectionDataTableTableName Eşleşen MappingNamebir ile yoksaDataGridTableStyle, DataTable veri kılavuzu tabloları için varsayılan stille görüntülenir.

2. Farklı bir kılavuz stili gerektiğinde, uygun öğesini seçmek için özelliğini kullanın Item (özelliğine Item[] geçirinTableName) ve döndürülen nesnenin değerini yeni bir değere ayarlayınMappingName.DataGridTableStyle

3. Item[] İstenen DataGridTableStyleöğesini seçmek ve değerini olarak ayarlamak MappingName için TableNameDataTableözelliğini kullanın.

Şu anda hangilerinin DataGridTableStyle görüntülendiğini belirlemek için öğesinin DataSourceSystem.Windows.Forms.DataGrid ve DataMember özelliklerini kullanarak bir CurrencyManagerdöndürür. Veri kaynağı arabirimini uygularsaITypedList, geçerli tablonun döndürmek MappingName için yöntemini kullanabilirsinizGetListName. Bu, aşağıdaki C# kodunda gösterilmiştir:

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

DataSet nesneleriyle DataRelation ilgili nesneleri içeriyorsa DataTable ve şu anda görüntülenen DataTable bir alt tabloysa, DataMember TableName.RelationName biçiminde bir dize döndürür (en basit durumda). DataTable hiyerarşisinde daha aşağıdaysa, dize üst tablonun adından ve ardından tablonun düzeyine ulaşmak için gereken RelationName değerlerden oluşur. Örneğin, (yukarıdan aşağıya) Regions, ve adlı hiyerarşik bir ilişkide üç DataTable nesnenin ve Ordersve CustomersToOrdersadlı RegionsToCustomers iki DataRelation nesnenin ,özelliğinin DataMember "Regions.RegionsToCustomers.CustomersToOrders" döndüreceğini Customersdüşünün. Ancak, MappingName "Siparişler" olacaktır.

Nesne koleksiyonuDataGridTableStyle, özelliği System.Windows.Forms.DataGridaracılığıyla TableStyles döndürülür.

DataGridTableStyle görüntülendiğinde, için DataGridTableStyle ayarları denetimin ayarlarını System.Windows.Forms.DataGrid geçersiz kılar. Belirli DataGridTableStyle bir özellik için bir değer ayarlanmadıysa, bunun yerine denetimin System.Windows.Forms.DataGrid değeri kullanılır. Aşağıdaki listede, denetim özelliklerini geçersiz kılacak System.Windows.Forms.DataGrid şekilde ayarlanabilen özellikler gösterilirDataGridColumnStyle:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

öğesini kesin olarak belirlenmiş bir nesne dizisine bağlamak DataGrid için nesne türünün ortak özellikler içermesi gerekir. Diziyi görüntüleyen bir DataGridTableStyle oluşturmak için, özelliğini typename nesne türünün adıyla değiştirildiği konumuna typename ayarlayınDataGridTableStyle.MappingName. Ayrıca özelliğin büyük/küçük harfe MappingName duyarlı olduğunu unutmayın; tür adı tam olarak eşleşmelidir. Bir örnek için özelliğine MappingName bakın.

öğesini bir ArrayListöğesine de bağlayabilirsinizDataGrid. özelliğinin ArrayList bir özelliği, birden çok türde nesne içermesi, ancak DataGrid yalnızca listedeki tüm öğeler ilk öğeyle aynı türde olduğunda böyle bir listeye bağlanabilmesidir. Bu, tüm nesnelerin aynı türde olması veya listedeki ilk öğeyle aynı sınıftan devralması gerektiği anlamına gelir. Örneğin, listedeki ilk öğe bir Controlise, ikinci öğe bir TextBox olabilir (öğesinden Controldevralınır). Öte yandan, ilk öğe bir TextBoxise, ikinci nesne bir Contrololamaz. Ayrıca, bağlı olduğunda öğelerinin ArrayList olması ve içindeki nesnelerin ortak özellikler içermesi DataGridTableStyle gerekir. Boş ArrayList bir kılavuz boş bir kılavuza neden olur. bir ArrayListöğesine bağlanırken öğesinin değerini MappingNameDataGridTableStyle "ArrayList" (tür adı) olarak ayarlayın.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection