GridTableStylesCollection Sınıf

Tanım

Denetimdeki DataGrid bir nesne koleksiyonunu DataGridTableStyle temsil eder.

public ref class GridTableStylesCollection : System::Windows::Forms::BaseCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class GridTableStylesCollection : System.Windows.Forms.BaseCollection, System.Collections.IList
[<System.ComponentModel.ListBindable(false)>]
type GridTableStylesCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class GridTableStylesCollection
Inherits BaseCollection
Implements IList
Devralma
GridTableStylesCollection
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki kod örneği iki DataGridTableStyle nesne oluşturur ve her GridTableStylesCollection birini denetimin TableStylesDataGrid özelliği tarafından döndürülen öğesine ekler.

void AddCustomDataTableStyle()
{
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   // Set other properties.
   ts1->AlternatingBackColor = Color::LightGray;
   
   /* 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";
   
   // Set other properties.
   ts2->AlternatingBackColor = Color::LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   
   /*Use a PropertyDescriptor to create a formatted
     column. First get the PropertyDescriptorCollection
     for the data source and data member. */
   System::ComponentModel::PropertyDescriptorCollection^ pcol = this->
       BindingContext[myDataSet, "Customers::custToOrders"]->
       GetItemProperties();
   
   /* Create a formatted column using a PropertyDescriptor.
     The formatting character S"c" specifies a currency format. */
   DataGridColumnStyle^ csOrderAmount =
      gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   /* Add the DataGridTableStyle instances to
     the GridTableStylesCollection. */
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}
private void AddCustomDataTableStyle(){
   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   // Set other properties.
   ts1.AlternatingBackColor = Color.LightGray;

   /* 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";

   // Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle cOrderDate = 
   new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;
   ts2.GridColumnStyles.Add(cOrderDate);

   /*Use a PropertyDescriptor to create a formatted
   column. First get the PropertyDescriptorCollection
   for the data source and data member. */
   System.ComponentModel.PropertyDescriptorCollection pcol = 
      this.BindingContext[myDataSet, "Customers.custToOrders"]
      .GetItemProperties();
 
   /* Create a formatted column using a PropertyDescriptor.
   The formatting character "c" specifies a currency format. */     
   DataGridColumnStyle csOrderAmount = 
   new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
   ts2.GridColumnStyles.Add(csOrderAmount);

   /* Add the DataGridTableStyle instances to 
   the GridTableStylesCollection. */
   myDataGrid.TableStyles.Add(ts1);
   myDataGrid.TableStyles.Add(ts2);
}
Private Sub AddCustomDataTableStyle()
   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   ' Set other properties.
   ts1.AlternatingBackColor = Color.LightGray
   ' 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"
     
   ' Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue
     
   ' Create new ColumnStyle objects.
   Dim cOrderDate As New DataGridTextBoxColumn()
   cOrderDate.MappingName = "OrderDate"
   cOrderDate.HeaderText = "Order Date"
   cOrderDate.Width = 100
   ts2.GridColumnStyles.Add(cOrderDate)

   ' Use a PropertyDescriptor to create a formatted
   ' column. First get the PropertyDescriptorCollection
   ' for the data source and data member. 
   Dim pcol As System.ComponentModel.PropertyDescriptorCollection = _
   Me.BindingContext(myDataSet, "Customers.custToOrders"). _
   GetItemProperties()

   ' Create a formatted column using a PropertyDescriptor.
   ' The formatting character "c" specifies a currency format. */     
     
   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 instances to 
   ' the GridTableStylesCollection. 
   myDataGrid.TableStyles.Add(ts1)
   myDataGrid.TableStyles.Add(ts2)
End Sub

Açıklamalar

, GridTableStylesCollection denetimin DataGrid içindeki her DataTableDataSetbiri için özelleştirilmiş bir kılavuz stili görüntülemesine olanak tanıyan nesneler içerirDataGridTableStyle.

denetiminde DataGridTableStyles özelliği döndürür GridTableStylesCollection.

Varsayılan olarak, GridTableStylesCollection herhangi bir DataGridTableStyle nesne içermez. Bunun yerine, DataGrid her tabloyu renk, genişlik ve biçimlendirme için varsayılan ayarları kullanarak görüntüler. Her tablonun tüm sütunları görüntülenir. koleksiyona bir DataGridTableStyle eklendiğinde, DataGridMappingName kılavuz için verileri hangi nesnenin sağladığını belirlemek için kullanır. Örneğin, veri kaynağı üç DataTable nesne içeren bir DataSet ise, MappingName nesnelerden birinin eşleşmesi TableName gerekir. MappingName değeri herhangi bir değerle TableName eşleşmiyorsa, her tablonun verilerini görüntülemek için varsayılan ayarlar kullanılır ve DataGridTableStyle ayarlar yoksayılır.

Dikkat

Nesneleri her zaman oluşturun DataGridColumnStyle ve nesnesine GridColumnStylesCollection eklemeden DataGridTableStyleGridTableStylesCollectionönce öğesine ekleyin. Koleksiyona geçerli MappingName bir değer içeren boş DataGridTableStyle bir değer eklediğinizde, DataGridColumnStyle nesneler sizin için otomatik olarak oluşturulur. Sonuç olarak, öğesine yinelenen MappingName değerlere GridColumnStylesCollectionsahip yeni DataGridColumnStyle nesneler eklemeye çalışırsanız bir özel durum oluşturulur. Alternatif olarak yöntemini kullanarak işaretini Clear kaldırınGridColumnStylesCollection.

Özellikler

Count

Koleksiyondaki öğelerin toplam sayısını alır.

(Devralındığı yer: BaseCollection)
IsReadOnly

Topluluğun salt okunur olup olmadığını gösteren bir değer alır.

(Devralındığı yer: BaseCollection)
IsSynchronized

öğesine erişimin ICollection eşitlenip eşitlenmediğini belirten bir değer alır.

(Devralındığı yer: BaseCollection)
Item[Int32]

Dizine göre belirtilen değerini DataGridTableStyle alır.

Item[String]

Belirtilen ada sahip öğesini DataGridTableStyle alır.

List

Temel alınan listeyi alır.

SyncRoot

erişimi BaseCollectioneşitlemek için kullanılabilecek bir nesnesi alır.

(Devralındığı yer: BaseCollection)

Yöntemler

Add(DataGridTableStyle)

Bu koleksiyona bir DataGridTableStyle ekler.

AddRange(DataGridTableStyle[])

Koleksiyona tablo stilleri dizisi ekler.

Clear()

Koleksiyonu temizler.

Contains(DataGridTableStyle)

öğesinin belirtilen DataGridTableStyleöğesini içerip içermediğini GridTableStylesCollection belirten bir değer alır.

Contains(String)

öğesinin ada göre belirtilen öğesini DataGridTableStyle içerip içermediğini GridTableStylesCollection belirten bir değer alır.

CopyTo(Array, Int32)

Geçerli tek boyutlu Array öğenin tüm öğelerini belirtilen hedef Array dizinden başlayarak belirtilen tek boyutluya Array kopyalar.

(Devralındığı yer: BaseCollection)
CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetEnumerator()

Koleksiyonun üyeleri arasında yinelemeyi sağlayan nesnesini alır.

(Devralındığı yer: BaseCollection)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Olayı tetikler CollectionChanged .

Remove(DataGridTableStyle)

Belirtilen DataGridTableStyleöğesini kaldırır.

RemoveAt(Int32)

Belirtilen dizindeki bir DataGridTableStyle öğesini kaldırır.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Ekinlikler

CollectionChanged

Koleksiyon değiştiğinde gerçekleşir.

Belirtik Arabirim Kullanımları

ICollection.CopyTo(Array, Int32)

Koleksiyonu, hedef dizinin belirtilen dizininden başlayarak uyumlu bir tek boyutlu Arrayöğesine kopyalar.

ICollection.Count

Topluluktaki öğe sayısını alır.

ICollection.IsSynchronized

erişimin GridTableStylesCollection eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli).

ICollection.SyncRoot

Koleksiyona erişimi eşitlemek için kullanılabilecek bir nesne alır.

IEnumerable.GetEnumerator()

Koleksiyon için bir numaralandırıcı döndürür.

IList.Add(Object)

Bu koleksiyona bir DataGridTableStyle ekler.

IList.Clear()

Koleksiyonu temizler.

IList.Contains(Object)

Bir öğenin koleksiyonda olup olmadığını belirler.

IList.IndexOf(Object)

Koleksiyonda belirtilen nesnenin ilk oluşumunun sıfır tabanlı dizinini döndürür.

IList.Insert(Int32, Object)

Insert(Int32, Object) yöntemini uygular. Her zaman atar NotSupportedException.

IList.IsFixedSize

Koleksiyonun sabit bir boyuta sahip olup olmadığını gösteren bir değer alır.

IList.IsReadOnly

Topluluğun salt okunur olup olmadığını gösteren bir değer alır.

IList.Item[Int32]

Belirtilen dizindeki öğeyi alır veya ayarlar.

IList.Remove(Object)

Belirtilen DataGridTableStyleöğesini kaldırır.

IList.RemoveAt(Int32)

DataGridColumnStyle Belirtilen dizine sahip öğesini koleksiyondan kaldırır.

Uzantı Metotları

Cast<TResult>(IEnumerable)

öğesinin IEnumerable öğelerini belirtilen türe atar.

OfType<TResult>(IEnumerable)

Öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.

AsParallel(IEnumerable)

Sorgunun paralelleştirilmesini etkinleştirir.

AsQueryable(IEnumerable)

bir IEnumerable öğesini öğesine IQueryabledönüştürür.

Şunlara uygulanır

Ayrıca bkz.