GridTableStylesCollection 클래스

참조

정의

네임스페이스:: System.Windows.Forms

어셈블리:: System.Windows.Forms.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

DataGrid 컨트롤에 있는 DataGridTableStyle 개체의 컬렉션을 나타냅니다.

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 개체를 만들고 컨트롤의 DataGrid 속성에서 반환된 GridTableStylesCollection 에 TableStyles 각각을 추가합니다.

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 컨트롤이 의 각 DataTable 에 대해 사용자 지정된 그리드 스타일을 표시할 수 DataGrid 있는 개체가 포함되어 있습니다DataSet.

컨트롤에서 DataGrid 속성은 를 TableStyles 반환합니다 GridTableStylesCollection.

기본적으로 는 개체를 GridTableStylesCollection DataGridTableStyle 포함하지 않습니다. 대신 색, DataGrid 너비 및 서식에 대한 기본 설정을 사용하여 각 테이블을 표시합니다. 각 테이블의 모든 열이 표시됩니다. DataGridTableStyle 가 컬렉션에 추가되면 는 DataGrid 을 사용하여 MappingName 그리드에 대한 데이터를 제공하는 개체를 결정합니다. 예를 들어 데이터 원본이 3개의 DataTable 개체를 DataSet 포함하는 인 경우 는 개체 MappingName 중 하나의 을 TableName 일치시켜야 합니다. 이 MappingName 값과 TableName 일치하지 않으면 기본 설정이 각 테이블의 데이터를 표시하는 데 사용되며 설정은 DataGridTableStyle 무시됩니다.

주의

개체를 에 추가하기 전에 항상 개체GridTableStylesCollection를 GridColumnStylesCollection 만들고 DataGridColumnStyle 에 추가 DataGridTableStyle 합니다. 컬렉션 DataGridColumnStyle 에 유효한 MappingName 값이 있는 빈 DataGridTableStyle 을 추가하면 개체가 자동으로 생성됩니다. 따라서 중복 MappingName 값이 있는 새 DataGridColumnStyle 개체를 에 추가하려고 하면 예외가 GridColumnStylesCollectionthrow됩니다. 또는 메서드를 사용하여 를 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)	현재 1차원 Array의 모든 요소를 지정된 대상 Array 인덱스부터 시작하여 지정된 1차원 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)	대상 배열의 지정된 인덱스에서 시작하여 컬렉션을 호환되는 1차원 Array에 복사합니다.
ICollection.Count	컬렉션의 항목 수를 가져옵니다.
ICollection.IsSynchronized	GridTableStylesCollection에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.
ICollection.SyncRoot	컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.
IEnumerable.GetEnumerator()	컬렉션에 대한 열거자를 반환합니다.
IList.Add(Object)	이 컬렉션에 DataGridTableStyle를 추가합니다.
IList.Clear()	컬렉션을 지웁니다.
IList.Contains(Object)	요소가 컬렉션에 있는지 여부를 확인합니다.
IList.IndexOf(Object)	컬렉션에서 지정한 개체가 처음 나타나는 인덱스(0부터 시작)를 반환합니다.
IList.Insert(Int32, Object)	Insert(Int32, Object) 메서드를 구현합니다. 항상NotSupportedException을 throw합니다.
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 클래스

정의

예제

설명

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

추가 리소스