GridTableStylesCollection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет коллекцию объектов 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
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере кода создаются два DataGridTableStyle объекта и каждый из них добавляется в объект , GridTableStylesCollection возвращаемый свойством TableStylesDataGrid элемента управления .
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
Комментарии
содержит GridTableStylesCollectionDataGridTableStyle объекты , позволяющие элементу DataGrid управления отображать настраиваемый стиль сетки для каждого из них DataTable в DataSet.
В элементе DataGridTableStyles управления свойство возвращает GridTableStylesCollection.
По умолчанию объект 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. |