GridTableStylesCollection Klasa

Definicja

Reprezentuje kolekcję DataGridTableStyle obiektów w DataGrid kontrolce.Represents a collection of DataGridTableStyle objects in the DataGrid control.

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
Dziedziczenie
GridTableStylesCollection
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu tworzy dwa DataGridTableStyle obiekty i dodaje je do GridTableStylesCollection zwracanych przez TableStyles Właściwość DataGrid formantu.The following code example creates two DataGridTableStyle objects and adds each to the GridTableStylesCollection returned by the TableStyles property of a DataGrid control.

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

Uwagi

GridTableStylesCollectionZawiera DataGridTableStyle obiekty, które umożliwiają DataGrid kontrolce wyświetlanie dostosowanego stylu siatki dla każdego DataTable w DataSet .The GridTableStylesCollection contains DataGridTableStyle objects that allows the DataGrid control to display a customized grid style for each DataTable in a DataSet.

Na DataGrid kontrolce TableStyles Właściwość zwraca GridTableStylesCollection .On the DataGrid control, the TableStyles property returns the GridTableStylesCollection.

Domyślnie nie GridTableStylesCollection zawiera żadnych DataGridTableStyle obiektów.By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. Zamiast tego DataGrid wyświetla każdą tabelę przy użyciu domyślnych ustawień koloru, szerokości i formatowania.Instead, the DataGrid displays each table using default settings for color, width, and formatting. Zostaną wyświetlone wszystkie kolumny każdej tabeli.All columns of each table are displayed. Gdy DataGridTableStyle jest dodawany do kolekcji, DataGrid używa MappingName do określenia, który obiekt dostarcza dane dla siatki.When a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. Na przykład, jeśli źródło danych DataSet zawiera trzy DataTable obiekty, MappingName muszą one być zgodne z TableName jednym z obiektów.For example, if the data source is a DataSet that contains three DataTable objects, the MappingName must match the TableName of one of the objects. Jeśli MappingName nie pasuje do żadnej z TableName wartości, ustawienia domyślne zostaną użyte do wyświetlania danych dla każdej tabeli, a DataGridTableStyle Ustawienia zostaną zignorowane.If the MappingName does not match any of the TableName values, the default settings will be used to display data for each table, and the DataGridTableStyle settings will be ignored.

Przestroga

Zawsze twórz DataGridColumnStyle obiekty i Dodaj je do GridColumnStylesCollection obiektu przed dodaniem do DataGridTableStyle programu GridTableStylesCollection .Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Po dodaniu pustej DataGridTableStyle MappingName wartości do kolekcji DataGridColumnStyle obiekty są generowane automatycznie.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. W związku z tym wyjątek zostanie wygenerowany, jeśli spróbujesz dodać nowe DataGridColumnStyle obiekty ze zduplikowanymi MappingName wartościami do GridColumnStylesCollection .Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. Alternatywnie Wyczyść GridColumnStylesCollection metodę przy użyciu Clear metody.Alternatively, clear the GridColumnStylesCollection using the Clear method.

Właściwości

Count

Pobiera łączną liczbę elementów w kolekcji.Gets the total number of elements in the collection.

(Odziedziczone po BaseCollection)
IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.Gets a value indicating whether the collection is read-only.

(Odziedziczone po BaseCollection)
IsSynchronized

Pobiera wartość wskazującą, czy dostęp do programu ICollection jest synchronizowany.Gets a value indicating whether access to the ICollection is synchronized.

(Odziedziczone po BaseCollection)
Item[Int32]

Pobiera DataGridTableStyle określony przez indeks.Gets the DataGridTableStyle specified by index.

Item[String]

Pobiera DataGridTableStyle o podanej nazwie.Gets the DataGridTableStyle with the specified name.

List

Pobiera podstawową listę.Gets the underlying list.

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do BaseCollection .Gets an object that can be used to synchronize access to the BaseCollection.

(Odziedziczone po BaseCollection)

Metody

Add(DataGridTableStyle)

Dodaje DataGridTableStyle do tej kolekcji.Adds a DataGridTableStyle to this collection.

AddRange(DataGridTableStyle[])

Dodaje tablicę stylów tabeli do kolekcji.Adds an array of table styles to the collection.

Clear()

Czyści kolekcję.Clears the collection.

Contains(DataGridTableStyle)

Pobiera wartość wskazującą GridTableStylesCollection , czy zawiera określony element DataGridTableStyle .Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

Pobiera wartość wskazującą GridTableStylesCollection , czy zawiera DataGridTableStyle określony przez nazwę.Gets a value indicating whether the GridTableStylesCollection contains the DataGridTableStyle specified by name.

CopyTo(Array, Int32)

Kopiuje wszystkie elementy z prądu jednowymiarowego Array do określonego, Array rozpoczynając od określonego Array indeksu docelowego.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Odziedziczone po BaseCollection)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Pobiera obiekt, który umożliwia wykonywanie iteracji przez elementy członkowskie kolekcji.Gets the object that enables iterating through the members of the collection.

(Odziedziczone po BaseCollection)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Podnosi CollectionChanged zdarzenie.Raises the CollectionChanged event.

Remove(DataGridTableStyle)

Usuwa określony DataGridTableStyle .Removes the specified DataGridTableStyle.

RemoveAt(Int32)

Usuwa o DataGridTableStyle określonym indeksie.Removes a DataGridTableStyle at the specified index.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Zdarzenia

CollectionChanged

Występuje, gdy kolekcja została zmieniona.Occurs when the collection has changed.

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Kopiuje kolekcję do zgodnego jednowymiarowego Array , rozpoczynając od określonego indeksu tablicy docelowej.Copies the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Pobiera liczbę elementów w kolekcji.Gets the number of items in the collection.

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do elementu GridTableStylesCollection jest synchronizowany (bezpieczny wątkowo).Gets a value indicating whether access to the GridTableStylesCollection is synchronized (thread safe).

ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Zwraca moduł wyliczający dla kolekcji.Returns an enumerator for the collection.

IList.Add(Object)

Dodaje DataGridTableStyle do tej kolekcji.Adds a DataGridTableStyle to this collection.

IList.Clear()

Czyści kolekcję.Clears the collection.

IList.Contains(Object)

Określa, czy element znajduje się w kolekcji.Determines whether an element is in the collection.

IList.IndexOf(Object)

Zwraca indeks (liczony od zera) pierwszego wystąpienia określonego obiektu w kolekcji.Returns the zero-based index of the first occurrence of the specified object in the collection.

IList.Insert(Int32, Object)

Implementuje Insert(Int32, Object) metodę.Implements the Insert(Int32, Object) method. Zawsze zgłasza NotSupportedException .Always throws NotSupportedException.

IList.IsFixedSize

Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Pobiera lub ustawia element pod określonym indeksem.Gets or sets the element at the specified index.

IList.Remove(Object)

Usuwa określony DataGridTableStyle .Removes the specified DataGridTableStyle.

IList.RemoveAt(Int32)

Usuwa DataGridColumnStyle z kolekcji z określonym indeksem.Removes the DataGridColumnStyle with the specified index from the collection.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też