GridTableStylesCollection Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von DataGridTableStyle -Objekten im DataGrid -Steuerelement dar.

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

Vererbung: Object

MarshalByRefObject

BaseCollection
GridTableStylesCollection

Attribute: ListBindableAttribute

Implementiert: ICollection IEnumerable IList

Beispiele

Im folgenden Codebeispiel werden zwei DataGridTableStyle -Objekte erstellt und jeweils dem hinzugefügt, das GridTableStylesCollection von der TableStyles -Eigenschaft eines DataGrid -Steuerelements zurückgegeben wird.

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

Hinweise

GridTableStylesCollection enthält DataGridTableStyle Objekte, mit denen das DataGrid Steuerelement eine benutzerdefinierte Rasterart für jedes DataTable in einem DataSetanzeigen kann.

Für das DataGrid -Steuerelement gibt die TableStyles -Eigenschaft den GridTableStylesCollectionzurück.

Standardmäßig enthält das GridTableStylesCollection keine DataGridTableStyle -Objekte. Stattdessen wird jede Tabelle mithilfe der DataGrid Standardeinstellungen für Farbe, Breite und Formatierung angezeigt. Alle Spalten jeder Tabelle werden angezeigt. Wenn der Auflistung ein DataGridTableStyle hinzugefügt wird, verwendet die DataGrid MappingName , um zu bestimmen, welches Objekt die Daten für das Raster bereitstellt. Wenn die Datenquelle beispielsweise eine DataSet ist, die drei DataTable -Objekte enthält, muss mit MappingName dem TableName eines der -Objekte übereinstimmen. Wenn mit MappingName keinem der TableName Werte übereinstimmt, werden die Standardeinstellungen verwendet, um Daten für jede Tabelle anzuzeigen, und die DataGridTableStyle Einstellungen werden ignoriert.

Achtung

Erstellen Sie DataGridColumnStyle immer Objekte, und fügen Sie sie dem GridColumnStylesCollection hinzu, bevor Sie Objekte zu hinzufügen DataGridTableStyle GridTableStylesCollection. Wenn Sie der Auflistung einen leeren DataGridTableStyle mit einem gültigen MappingName Wert hinzufügen, DataGridColumnStyle werden automatisch Objekte für Sie generiert. Folglich wird eine Ausnahme ausgelöst, wenn Sie versuchen, dem neue DataGridColumnStyle Objekte mit doppelten MappingName Werten GridColumnStylesCollectionhinzuzufügen. Löschen Sie alternativ die GridColumnStylesCollection mithilfe der Clear -Methode.

Eigenschaften

Count	Ruft die Gesamtanzahl der in der Auflistung enthaltenen Elemente ab. (Geerbt von BaseCollection)
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist. (Geerbt von BaseCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert ist. (Geerbt von BaseCollection)
Item[Int32]	Ruft den durch den Index angegebenen DataGridTableStyle ab.
Item[String]	Ruft den DataGridTableStyle mit dem angegebenen Namen ab.
List	Ruft die zugrunde liegende Liste ab.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf BaseCollection synchronisiert werden kann. (Geerbt von BaseCollection)

Methoden

Add(DataGridTableStyle)	Fügt dieser Auflistung einen DataGridTableStyle hinzu.
AddRange(DataGridTableStyle[])	Fügt der Auflistung ein Array von Tabellenformaten hinzu.
Clear()	Löscht die Auflistung.
Contains(DataGridTableStyle)	Ruft einen Wert ab, der angibt, ob die GridTableStylesCollection den angegebenen DataGridTableStyle enthält.
Contains(String)	Ruft einen Wert ab, der angibt, ob GridTableStylesCollection den mit dem Namen angegebenen DataGridTableStyle enthält.
CopyTo(Array, Int32)	Kopiert alle Elemente des aktuellen eindimensionalen Array in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array. (Geerbt von BaseCollection)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Ruft das Objekt ab, mit dem die Member der Auflistung durchlaufen werden können. (Geerbt von BaseCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Löst das CollectionChanged-Ereignis aus.
Remove(DataGridTableStyle)	Entfernt den angegebenen DataGridTableStyle.
RemoveAt(Int32)	Entfernt einen DataGridTableStyle am angegebenen Index.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

CollectionChanged

Tritt ein, wenn die Auflistung geändert wurde.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die Auflistung in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.
ICollection.Count	Ruft die Anzahl der Elemente in der Auflistung ab.
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die GridTableStylesCollection synchronisiert (threadsicher) ist.
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.
IEnumerable.GetEnumerator()	Gibt einen Enumerator für die Auflistung zurück.
IList.Add(Object)	Fügt dieser Auflistung einen DataGridTableStyle hinzu.
IList.Clear()	Löscht die Auflistung.
IList.Contains(Object)	Bestimmt, ob sich ein Element in der Auflistung befindet.
IList.IndexOf(Object)	Gibt den nullbasierten Index des ersten Vorkommens des angegebenen Objekts in der Auflistung zurück.
IList.Insert(Int32, Object)	Implementiert die Insert(Int32, Object)-Methode. Löst immer NotSupportedException aus.
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest.
IList.Remove(Object)	Entfernt den angegebenen DataGridTableStyle.
IList.RemoveAt(Int32)	Entfernt den DataGridColumnStyle mit dem angegebenen Namen aus der Auflistung.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Freigeben über