DataGridView.RowTemplate 속성


컨트롤에 있는 모든 행의 템플릿을 나타내는 행을 가져오거나 설정합니다.Gets or sets the row that represents the template for all the rows in the control.

 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set
Public Property RowTemplate As DataGridViewRow

속성 값

행 템플릿을 나타내는 DataGridViewRow입니다.A DataGridViewRow representing the row template.



이 속성을 설정할 때 지정된 행이 해당 DataGridView 속성 집합을 가지는 경우The specified row when setting this property has its DataGridView property set.


다음 코드 예제에서는 행 템플릿을 사용 하 여 초기 행 높이 및 최소 행 높이 지정 하는 방법을 보여 줍니다.The following code example illustrates how to use the row template to specify an initial row height and a minimum row height.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;

DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With


경우에 따라 다양 한 DataGridView 셀 스타일 속성에서 제공 하는 것 보다 DataGridView 행의 모양을 보다 효과적으로 제어할 수 있습니다.Sometimes you want greater control over the appearance of DataGridView rows than what is provided by the various DataGridView cell style properties. RowTemplate 속성을 사용 하면 AllowUserToAddRows true경우 새 레코드의 행을 포함 하 여 모든 행에서 템플릿으로 사용할 DataGridViewRow을 만들고 초기화할 수 있습니다.The RowTemplate property lets you create and initialize a DataGridViewRow for use as a template by all rows, including the row for new records if AllowUserToAddRows is true.

행 높이 같은 속성에 대 한 기본값을 설정 하는 경우에 유용 합니다.This is useful when you are setting default values for properties such as row height. 예를 들어, 다음 여러 열에 걸쳐 있는 콘텐츠를 표시 하는 것에 대 한 일반 셀 내용 아래에 추가 공간을 제공 하기 위해 기본 행 높이 향상 하는 것이 좋습니다.For example, you may want to increase the default row height in order to provide extra room beneath ordinary cell content for displaying content that spans multiple columns.

DataGridViewRow 클래스에서 파생 된 사용자 지정 형식을 사용 하 여 외부 데이터를 표시 하는 경우 행 템플릿을 설정 해야 합니다.Setting the row template is necessary when external data is displayed using custom types derived from the DataGridViewRow class. 바인딩되지 않은 DataGridView 컨트롤을 사용 하면 사용자 지정 행 형식의 인스턴스로 Rows 컬렉션을 프로그래밍 방식으로 채울 수 있습니다.With unbound DataGridView controls, you can programmatically populate the Rows collection with instances of your custom row type. 그러나 외부 데이터를 표시할 때 행은 자동으로 생성 되지만 해당 템플릿을 기반으로 행을 사용자 지정 행 형식의 인스턴스로 설정할 수 있습니다.When displaying external data, however, the rows are generated automatically, but they are based on the row template, which you can set to an instance of your custom row type.

처음으로 값을 검색할 때이 속성이 설정 되지 않은 경우 새 DataGridViewRow 생성 되 고 반환 됩니다.If this property has not been set the first time you retrieve its value, a new DataGridViewRow is created and returned.

적용 대상

추가 정보