DataGrid.TableStyles 속성

정의

표의 DataGridTableStyle 개체 컬렉션을 가져옵니다.Gets the collection of DataGridTableStyle objects for the grid.

public:
 property System::Windows::Forms::GridTableStylesCollection ^ TableStyles { System::Windows::Forms::GridTableStylesCollection ^ get(); };
public System.Windows.Forms.GridTableStylesCollection TableStyles { get; }
member this.TableStyles : System.Windows.Forms.GridTableStylesCollection
Public ReadOnly Property TableStyles As GridTableStylesCollection

속성 값

GridTableStylesCollection

GridTableStylesCollection 개체의 컬렉션을 나타내는 DataGridTableStyle입니다.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

예제

다음 코드 예제에서는에 있는 각에 대해를 하나씩 만들고의를의 DataGridTableStyle DataTable DataSet 로 설정 합니다 MappingName DataGridTableStyle TableName DataTable .The following code example creates one DataGridTableStyle for each DataTable found in a DataSet, and sets the MappingName of the DataGridTableStyle to the TableName of the DataTable. DataGridTableStyle그런 다음 GridTableStylesCollection 속성에서 반환 된에를 추가 합니다 TableStyles .The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. 또한이 예제에서는에서 각의 MappingName DataGridColumnStyle 속성에 GridColumnStylesCollection 의해 반환 된에 각의를 출력 합니다 GridColumnStyles DataGridTableStyle GridTableStylesCollection .The example also prints the MappingName of each DataGridColumnStyle in the GridColumnStylesCollection returned by the GridColumnStyles property of each DataGridTableStyle in the GridTableStylesCollection.

private:
   void AddTables( DataGrid^ myDataGrid, DataSet^ myDataSet )
   {
      for each ( DataTable^ t in myDataSet->Tables )
      {
         DataGridTableStyle^ myGridTableStyle =
            gcnew DataGridTableStyle;
         myGridTableStyle->MappingName = t->TableName;
         myDataGrid->TableStyles->Add( myGridTableStyle );
         
         /* Note that DataGridColumnStyle objects will
            be created automatically for the first DataGridTableStyle
            when you add it to the GridTableStylesCollection.*/
      }
   }

   void PrintGridStyleInfo( DataGrid^ myDataGrid )
   {
      /* Print the MappingName of each DataGridTableStyle,
         and the MappingName of each DataGridColumnStyle. */
      for each ( DataGridTableStyle^ myGridStyle in
         myDataGrid->TableStyles )
      {
         Console::WriteLine( myGridStyle->MappingName );
         for each ( DataGridColumnStyle^ myColumnStyle in
            myGridStyle->GridColumnStyles )
         {
            Console::WriteLine( myColumnStyle->MappingName );
         }
      }
   }
private void AddTables(DataGrid myDataGrid, DataSet myDataSet){
   foreach(DataTable t in myDataSet.Tables){
      DataGridTableStyle myGridTableStyle = new 
      DataGridTableStyle();
      myGridTableStyle.MappingName = t.TableName;
      myDataGrid.TableStyles.Add(myGridTableStyle);

      /* Note that DataGridColumnStyle objects will
      be created automatically for the first DataGridTableStyle
      when you add it to the GridTableStylesCollection.*/
   }
}
private void PrintGridStyleInfo(DataGrid myDataGrid){
   /* Print the MappingName of each DataGridTableStyle,
   and the MappingName of each DataGridColumnStyle. */
   foreach(DataGridTableStyle myGridStyle in 
   myDataGrid.TableStyles){
   Console.WriteLine(myGridStyle.MappingName);
   foreach(DataGridColumnStyle myColumnStyle in 
      myGridStyle.GridColumnStyles){
  Console.WriteLine(myColumnStyle.MappingName);
      }
   }
}
 
Private Sub AddTables(myDataGrid As DataGrid, _
myDataSet As DataSet )
    Dim t As DataTable 
    For Each t in myDataSet.Tables
       Dim myGridTableStyle As DataGridTableStyle  = new _
       DataGridTableStyle()
       myGridTableStyle.MappingName = t.TableName
       myDataGrid.TableStyles.Add(myGridTableStyle)
       ' Note that DataGridColumnStyle objects will
       ' be created automatically for the first DataGridTableStyle
       ' when you add it to the GridTableStylesCollection.*/
    Next
 End Sub
 Private Sub PrintGridStyleInfo(myDataGrid As DataGrid )
    Dim myGridStyle As DataGridTableStyle
    Dim myColumnStyle As DataGridColumnStyle
    
    for each myGridStyle in _
    myDataGrid.TableStyles
       Console.WriteLine(myGridStyle.MappingName)
       for each myColumnStyle in myGridStyle.GridColumnStyles
      Console.WriteLine(myColumnStyle.MappingName)
       Next
    Next
 End Sub    

설명

속성을 GridTableStylesCollection 통해 검색 된를 사용 하 여 TableStyles 컨트롤에 의해 표시 되는 각 테이블의 사용자 지정 뷰를 만듭니다 System.Windows.Forms.DataGrid .Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

기본적으로 속성으로 반환 된 컬렉션에는 TableStyles 개체가 포함 되지 않습니다 DataGridTableStyle .By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. 사용자 지정 된 보기 집합을 만들려면 다음을 수행 합니다.To create a set of customized views:

  1. DataGridTableStyle를 만듭니다.Create a DataGridTableStyle.

  2. MappingName표 형태 테이블 개체의를의로 설정 합니다 TableName DataTable .Set the MappingName of the grid table object to the TableName of the DataTable.

  3. DataGridColumnStyle표시 하려는 각 그리드 열에 대해 하나씩 개체를 GridColumnStylesCollection 속성에서 반환한에 추가 합니다 GridColumnStyles .Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. 의를의로 설정 합니다 MappingName DataGridColumnStyle ColumnName DataColumn .Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. DataGridTableStyle속성에서 반환 된 컬렉션에 개체를 추가 TableStyles 합니다.Add the DataGridTableStyle object to the collection returned by TableStyles property.

주의

개체를에 추가 하기 전에 항상 개체를 만들어에 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. 따라서 DataGridColumnStyle 값이 중복 되는 새 개체를에 추가 하려고 하면 예외가 throw 됩니다 MappingName GridColumnStylesCollection .Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

적용 대상

추가 정보