GridTableStylesCollection Klasa

Definicja

Reprezentuje kolekcję DataGridTableStyle obiektów DataGrid w 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
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 DataGridTableStyle przykład kodu tworzy dwa obiekty i dodaje GridTableStylesCollection je do zwracanych DataGrid przez TableStyles właściwość 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

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

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

Domyślnie GridTableStylesCollection nie zawiera żadnych DataGridTableStyle obiektów.By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. Zamiast tego wyświetla każdą tabelę przy użyciu domyślnych ustawień koloru, szerokości i formatowania. DataGridInstead, 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 jest dodawany do kolekcji DataGrid , używa MappingName do określenia, który obiekt dostarcza dane dla siatki. DataGridTableStyleWhen a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. Na DataSet przykład, jeśli źródło danych zawiera trzy DataTable obiekty TableName , MappingName muszą one być zgodne z 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 nie pasuje do żadnej TableName z wartości, ustawienia domyślne zostaną użyte do wyświetlania danych dla DataGridTableStyle każdej tabeli, a ustawienia zostaną zignorowane. MappingNameIf 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 GridColumnStylesCollection do obiektu przed dodaniem DataGridTableStyle do programu GridTableStylesCollection.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Po dodaniu pustej DataGridTableStyle MappingName DataGridColumnStyle wartości do kolekcji 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. GridColumnStylesCollectionConsequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. Alternatywnie Wyczyść GridColumnStylesCollection Clear metodę przy użyciu 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 tylko do odczytu.Gets a value indicating whether the collection is read-only.

(Odziedziczone po BaseCollection)
IsSynchronized

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

(Odziedziczone po BaseCollection)
Item[Int32]

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

Item[String]

DataGridTableStyle Pobiera 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)

DataGridTableStyle Dodaje 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ą, czy GridTableStylesCollection zawiera określony DataGridTableStyleelement.Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

Pobiera wartość wskazującą, GridTableStylesCollection DataGridTableStyle czy zawiera 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 indeksu docelowego Array .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 określony obiekt jest równy bieżącemu obiektowi.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()

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()

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

(Odziedziczone po Object)
InitializeLifetimeService()

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 Objectelementu.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)

CollectionChanged Podnosi zdarzenie.Raises the CollectionChanged event.

Remove(DataGridTableStyle)

Usuwa określony DataGridTableStyle.Removes the specified DataGridTableStyle.

RemoveAt(Int32)

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

ToString()

Zwraca ciąg, który reprezentuje 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ą, GridTableStylesCollection czy dostęp do elementu 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)

DataGridTableStyle Dodaje 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)

Insert(Int32, Object) Implementuje 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 tylko do odczytu.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Pobieranie lub konfigurowanie elementów 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)

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

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy 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)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też