GridTableStylesCollection 클래스

정의

DataGrid 컨트롤에 있는 DataGridTableStyle 개체의 컬렉션을 나타냅니다.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
상속
GridTableStylesCollection
특성
구현

예제

다음 코드 예제에서는 두 DataGridTableStyle 개체를 추가 하는 각 합니다 GridTableStylesCollection 반환한를 TableStyles 의 속성을 DataGrid 컨트롤.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

설명

GridTableStylesCollection 포함 DataGridTableStyle 허용 하는 개체를 DataGrid 각각에 대 한 사용자 지정된 눈금 스타일을 표시 하도록 컨트롤 DataTableDataSet합니다.The GridTableStylesCollection contains DataGridTableStyle objects that allows the DataGrid control to display a customized grid style for each DataTable in a DataSet.

DataGrid 컨트롤을 TableStyles 속성에서 반환을 GridTableStylesCollection합니다.On the DataGrid control, the TableStyles property returns the GridTableStylesCollection.

기본적으로 GridTableStylesCollection 없는지 DataGridTableStyle 개체입니다.By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. 대신는 DataGrid 색, 너비 및 서식 지정에 대 한 기본 설정을 사용 하 여 각 테이블을 표시 합니다.Instead, the DataGrid displays each table using default settings for color, width, and formatting. 각 테이블의 모든 열이 표시 됩니다.All columns of each table are displayed. 경우는 DataGridTableStyle 컬렉션에 추가 됩니다는 DataGrid 사용 하 여는 MappingName 표에 대 한 데이터를 제공 하는 개체를 확인 하려면.When a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. 예를 들어 데이터 원본이 DataSet 세 개를 포함 하는 DataTable 개체를 MappingName 일치 해야 합니다는 TableName 개체 중 하나입니다.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. 경우는 MappingName 하나라도 일치 하지 않습니다 합니다 TableName 값, 각 테이블에 대 한 데이터를 표시 하려면 사용할 설정을 기본값 및 DataGridTableStyle 설정이 무시 됩니다.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.

주의

항상 만들기 DataGridColumnStyle 개체에 추가 하는 GridColumnStylesCollection 추가 하기 전에 DataGridTableStyle 개체는 GridTableStylesCollection합니다.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. 빈을 추가 하는 경우 DataGridTableStyle 을 올바른 MappingName 컬렉션에 값 DataGridColumnStyle 개체를 자동으로 생성 됩니다.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. 새로 추가 하려고 하면 예외가 throw 될 따라서 DataGridColumnStyle 중복을 사용 하 여 개체 MappingName 값을 GridColumnStylesCollection입니다.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. 또는 선택을 취소 합니다 GridColumnStylesCollection 를 사용 하 여를 Clear 메서드.Alternatively, clear the GridColumnStylesCollection using the Clear method.

속성

Count

컬렉션의 총 요소 수를 가져옵니다.Gets the total number of elements in the collection.

(다음에서 상속됨 BaseCollection)
IsReadOnly

컬렉션이 읽기 전용인지를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection is read-only.

(다음에서 상속됨 BaseCollection)
IsSynchronized

ICollection에 대한 액세스가 동기화되는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether access to the ICollection is synchronized.

(다음에서 상속됨 BaseCollection)
Item[Int32]

인덱스로 지정된 DataGridTableStyle을 가져옵니다.Gets the DataGridTableStyle specified by index.

Item[String]

지정된 이름을 가진 DataGridTableStyle를 가져옵니다.Gets the DataGridTableStyle with the specified name.

List

기본 목록을 가져옵니다.Gets the underlying list.

SyncRoot

BaseCollection에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the BaseCollection.

(다음에서 상속됨 BaseCollection)

메서드

Add(DataGridTableStyle)

이 컬렉션에 DataGridTableStyle를 추가합니다.Adds a DataGridTableStyle to this collection.

AddRange(DataGridTableStyle[])

컬렉션에 테이블 스타일의 배열을 추가합니다.Adds an array of table styles to the collection.

Clear()

컬렉션을 지웁니다.Clears the collection.

Contains(DataGridTableStyle)

GridTableStylesCollection에 지정한 DataGridTableStyle가 포함되는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

이름별로 지정된 GridTableStylesCollectionDataGridTableStyle에 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the GridTableStylesCollection contains the DataGridTableStyle specified by name.

CopyTo(Array, Int32)

현재 1차원 Array의 모든 요소를 지정된 대상 Array 인덱스부터 시작하여 지정된 1차원 Array에 복사합니다.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(다음에서 상속됨 BaseCollection)
CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetEnumerator()

컬렉션의 멤버 전체를 반복하도록 허용하는 개체를 가져옵니다.Gets the object that enables iterating through the members of the collection.

(다음에서 상속됨 BaseCollection)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

CollectionChanged 이벤트를 발생시킵니다.Raises the CollectionChanged event.

Remove(DataGridTableStyle)

지정된 DataGridTableStyle을 제거합니다.Removes the specified DataGridTableStyle.

RemoveAt(Int32)

지정한 인덱스의 DataGridTableStyle을 제거합니다.Removes a DataGridTableStyle at the specified index.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

이벤트

CollectionChanged

컬렉션이 변경될 때 발생합니다.Occurs when the collection has changed.

명시적 인터페이스 구현

ICollection.CopyTo(Array, Int32)

대상 배열의 지정된 인덱스에서 시작하여 컬렉션을 호환되는 1차원 Array에 복사합니다.Copies the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

컬렉션의 항목 수를 가져옵니다.Gets the number of items in the collection.

ICollection.IsSynchronized

GridTableStylesCollection에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.Gets a value indicating whether access to the GridTableStylesCollection is synchronized (thread safe).

ICollection.SyncRoot

컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

컬렉션에 대한 열거자를 반환합니다.Returns an enumerator for the collection.

IList.Add(Object)

이 컬렉션에 DataGridTableStyle를 추가합니다.Adds a DataGridTableStyle to this collection.

IList.Clear()

컬렉션을 지웁니다.Clears the collection.

IList.Contains(Object)

요소가 컬렉션에 있는지 여부를 확인합니다.Determines whether an element is in the collection.

IList.IndexOf(Object)

컬렉션에서 지정한 개체가 처음 나타나는 인덱스(0부터 시작)를 반환합니다.Returns the zero-based index of the first occurrence of the specified object in the collection.

IList.Insert(Int32, Object)

Insert(Int32, Object) 메서드를 구현합니다.Implements the Insert(Int32, Object) method. 항상NotSupportedException을 throw합니다.Always throws NotSupportedException.

IList.IsFixedSize

컬렉션의 크기가 고정되어 있는지를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

컬렉션이 읽기 전용인지를 나타내는 값을 가져옵니다.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

지정한 인덱스에 있는 요소를 가져오거나 설정합니다.Gets or sets the element at the specified index.

IList.Remove(Object)

지정된 DataGridTableStyle을 제거합니다.Removes the specified DataGridTableStyle.

IList.RemoveAt(Int32)

컬렉션에서 지정된 인덱스의 DataGridColumnStyle을 제거합니다.Removes the DataGridColumnStyle with the specified index from the collection.

확장 메서드

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

적용 대상

추가 정보