GridTableStylesCollection Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет коллекцию объектов DataGridTableStyle в элементе управления DataGrid.

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

Наследование: Object

MarshalByRefObject

BaseCollection
GridTableStylesCollection

Атрибуты: ListBindableAttribute

Реализации: ICollection IEnumerable IList

Примеры

В следующем примере кода создаются два DataGridTableStyle объекта и каждый из них добавляется в объект , GridTableStylesCollection возвращаемый свойством TableStyles DataGrid элемента управления .

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

По умолчанию объект GridTableStylesCollection не содержит никаких DataGridTableStyle объектов . Вместо этого отображает каждую таблицу DataGrid с параметрами по умолчанию для цвета, ширины и форматирования. Отображаются все столбцы каждой таблицы. DataGridTableStyle При добавлении в коллекцию объект использует MappingName , чтобы определить, DataGrid какой объект предоставляет данные для сетки. Например, если источником данных является объект , DataSet содержащий три DataTable объекта , MappingName объект должен соответствовать TableName одному из объектов . MappingName Если не соответствует ни одному из значенийTableName, параметры по умолчанию будут использоваться для отображения данных для каждой таблицы, а DataGridTableStyle параметры будут игнорироваться.

Внимание!

Всегда создавайте DataGridColumnStyle объекты и добавляйте их в перед GridColumnStylesCollection добавлением DataGridTableStyle объектов в GridTableStylesCollection. При добавлении пустого DataGridTableStyle объекта с допустимым MappingName значением в коллекцию DataGridColumnStyle автоматически создаются объекты. Следовательно, при попытке добавить новые DataGridColumnStyle объекты с повторяющимися MappingName значениями GridColumnStylesCollectionв будет создано исключение . Кроме того, можно очистить с GridColumnStylesCollection помощью Clear метода .

Свойства

Count	Возвращает общее количество элементов в коллекции. (Унаследовано от BaseCollection)
IsReadOnly	Возвращает значение, указывающее, является ли коллекция доступной только для чтения. (Унаследовано от BaseCollection)
IsSynchronized	Возвращает значение, определяющее, синхронизирован ли доступ к интерфейсу ICollection. (Унаследовано от BaseCollection)
Item[Int32]	Получает объект DataGridTableStyle, заданный индексом.
Item[String]	Возвращает объект DataGridTableStyle с указанным именем.
List	Возвращает базовый список.
SyncRoot	Получает объект, с помощью которого можно синхронизировать доступ к коллекции BaseCollection. (Унаследовано от BaseCollection)

Методы

Add(DataGridTableStyle)	Добавляет в данную коллекцию элемент DataGridTableStyle.
AddRange(DataGridTableStyle[])	Добавляет в коллекцию массив стилей таблиц.
Clear()	Очищает коллекцию.
Contains(DataGridTableStyle)	Возвращает значение, указывающее, содержит ли GridTableStylesCollection указанную DataGridTableStyle.
Contains(String)	Получает значение, указывающее, содержит ли коллекция GridTableStylesCollection класс DataGridTableStyle с заданным именем.
CopyTo(Array, Int32)	Копирует все элементы текущего одномерного массива Array в заданный одномерный массив Array, начиная с указанного индекса в массиве назначения Array. (Унаследовано от BaseCollection)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Получает объект, позволяющий выполнять итерацию по элементам коллекции. (Унаследовано от BaseCollection)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Вызывает событие CollectionChanged.
Remove(DataGridTableStyle)	Удаляет указанный объект DataGridTableStyle.
RemoveAt(Int32)	Удаляет объект DataGridTableStyle по указанному индексу.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

CollectionChanged

Происходит при изменении коллекции.

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)	Копирует коллекцию в совместимый одномерный массив Array, начиная с указанного индекса конечного массива.
ICollection.Count	Возвращает количество элементов в коллекции.
ICollection.IsSynchronized	Возвращает значение, показывающее, является ли доступ к коллекции GridTableStylesCollection синхронизированным (потокобезопасным).
ICollection.SyncRoot	Возвращает объект, который можно использовать для синхронизации доступа к коллекции.
IEnumerable.GetEnumerator()	Возвращает перечислитель для коллекции.
IList.Add(Object)	Добавляет в данную коллекцию элемент DataGridTableStyle.
IList.Clear()	Очищает коллекцию.
IList.Contains(Object)	Определяет, входит ли элемент в состав коллекции.
IList.IndexOf(Object)	Возвращает отсчитываемый с нуля индекс первого вхождения в коллекцию заданного объекта.
IList.Insert(Int32, Object)	Реализует метод Insert(Int32, Object). Всегда создает исключение NotSupportedException.
IList.IsFixedSize	Возвращает значение, указывающее, имеет ли коллекция фиксированный размер.
IList.IsReadOnly	Возвращает значение, указывающее, является ли коллекция доступной только для чтения.
IList.Item[Int32]	Возвращает или задает элемент по указанному индексу.
IList.Remove(Object)	Удаляет указанный объект DataGridTableStyle.
IList.RemoveAt(Int32)	Удаляет из коллекции объект DataGridColumnStyle с заданным индексом.

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

Применяется к

GridTableStylesCollection Класс

Определение

Примеры

Комментарии

Свойства

Методы

События

Явные реализации интерфейса

Методы расширения

Применяется к

См. также раздел

Обратная связь

Дополнительные ресурсы