DataGridViewRow 클래스

정의

DataGridView 컨트롤의 행을 나타냅니다.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand
Public Class DataGridViewRow
Inherits DataGridViewBand
상속
특성

예제

다음 코드 예제에서는이 형식의 사용을 보여 줍니다. 이 예제는 방법: Windows Forms DataGridView 컨트롤의 행 조작에서 사용할 수 있는 더 큰 예제의 일부입니다.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}
// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

설명

합니다 DataGridViewRow 클래스의 행을 나타냅니다는 DataGridView 제어 합니다. 컨트롤의 및 SelectedRows 컬렉션을 통해 Rows 행을 검색할 수 있습니다.

에서는 DataGridViewColumn달리 에는 DataGridViewRow 해당 행에 있는 모든 셀의 컬렉션이 물리적으로 포함됩니다. 속성을 통해 이 컬렉션에 Cells 액세스할 수 있습니다.

클래스는 DataGridViewRow 개별 셀 요소에 액세스하고 높이 및 셀 스타일과 같은 행 UI(사용자 인터페이스)의 모양과 동작을 조정하는 데 사용됩니다. 일반적으로 컨트롤의 모든 행 또는 대부분의 행이 동일한 특성을 공유하도록 합니다. 컨트롤의 모든 행에 대한 셀 스타일을 설정하려면 속성에서 반환 DataGridView.RowsDefaultCellStyle 된 개체의 속성을 설정합니다. 행을 번갈아 가며 스타일을 설정하려면 속성을 사용합니다 DataGridView.AlternatingRowsDefaultCellStyle . 셀 스타일에 대한 자세한 내용은 Windows Forms DataGridView 컨트롤의 셀 스타일을 참조하세요. 속성을 사용하여 컨트롤에 DataGridView.RowTemplate 추가된 모든 행의 기준으로 사용할 행을 정의할 수도 있습니다.

컨트롤은 DataGridView 성능 저하를 방지하기 위해 가능하면 여러 데이터 행에서 개체를 공유 DataGridViewRow 합니다. 많은 양의 데이터를 사용하고 성능 문제가 발생하지 않는 한 일반적으로 행 공유를 무시할 수 있습니다. 공유 행은 -1의 속성 값으로 Index 표시됩니다. 클래스의 일부 멤버는 DataGridViewRow 공유 행과 함께 사용할 수 없지만 속성을 통해 DataGridViewRowCollection.Item[] 액세스하여 행을 공유 해제할 수 있습니다. 행은 다른 방법으로 공유되지 않게 될 수도 있습니다. 공유를 해제하지 않고 행에 액세스하려면 메서드를 DataGridViewRowCollection.SharedRow 사용합니다. 많은 양의 데이터를 사용하는 경우 성능 저하를 방지하기 위해 행을 공유하고 공유하지 않는 방법을 알고 있어야 합니다. 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기를 조정하는 최선의 방법을 참조하세요.

상속자 참고

파생 하는 경우 DataGridViewRow 파생된 클래스에 새 속성 추가 재정의 해야 합니다 Clone() 복제 작업 중 새 속성을 복사 하는 방법입니다. 또한 기본 클래스를 호출 해야 Clone() 메서드는 기본 클래스의 속성이 새로운 셀에 복사 되도록 합니다.

생성자

DataGridViewRow()

템플릿을 사용하지 않고 DataGridViewRow 클래스의 새 인스턴스를 초기화합니다.

속성

AccessibilityObject

DataGridViewRow.DataGridViewRowAccessibleObject에 할당된 DataGridViewRow를 가져옵니다.

Cells

행을 채우는 셀의 컬렉션을 가져옵니다.

ContextMenuStrip

행의 바로 가기 메뉴를 가져오거나 설정합니다.

DataBoundItem

행을 채운 데이터 바인딩된 개체를 가져옵니다.

DataGridView

이 요소와 관련된 DataGridView 컨트롤을 가져옵니다.

(다음에서 상속됨 DataGridViewElement)
DefaultCellStyle

스타일이 재정의되지 않는 경우 행의 셀을 렌더링하는 데 사용되는 행의 기본 스타일을 가져오거나 설정합니다.

DefaultHeaderCellType

기본 머리글 셀의 런타임 형식을 가져오거나 설정합니다.

(다음에서 상속됨 DataGridViewBand)
Displayed

이 행이 화면에 표시되는지 여부를 나타내는 값을 가져옵니다.

DividerHeight

행 구분선의 높이(픽셀)를 가져오거나 설정합니다.

ErrorText

행 수준 오류에 대한 오류 메시지 텍스트를 가져오거나 설정합니다.

Frozen

행이 고정되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

HasDefaultCellStyle

DefaultCellStyle 속성이 설정되었는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataGridViewBand)
HeaderCell

행의 머리글 셀을 가져오거나 설정합니다.

HeaderCellCore

DataGridViewBand의 머리글 셀을 가져오거나 설정합니다.

(다음에서 상속됨 DataGridViewBand)
Height

행의 현재 높이를 가져오거나 설정합니다.

Index

DataGridView 컨트롤에서 밴드의 상대적 위치를 가져옵니다.

(다음에서 상속됨 DataGridViewBand)
InheritedStyle

행에 적용되는 셀 스타일을 가져옵니다.

IsNewRow

행이 새 레코드에 대한 행인지 여부를 나타내는 값을 가져옵니다.

IsRow

밴드가 행을 나타내는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataGridViewBand)
MinimumHeight

행의 최소 높이를 가져오거나 설정합니다.

ReadOnly

행이 읽기 전용인지 여부를 나타내는 값을 가져오거나 설정합니다.

Resizable

사용자가 행의 크기를 조정할 수 있는지 여부를 나타내거나 크기 조정 동작이 AllowUserToResizeRows 속성에서 상속됨을 나타내는 값을 가져오거나 설정합니다.

Selected

행이 선택되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

State

행의 현재 상태를 가져옵니다.

Tag

밴드에 연결할 데이터가 포함된 개체를 가져오거나 설정합니다.

(다음에서 상속됨 DataGridViewBand)
Visible

행이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

지정된 조건에 따라 입력 행 머리글의 테두리 스타일을 수정합니다.

Clone()

이 행과 정확하게 일치하는 복사본을 만듭니다.

CreateAccessibilityInstance()

DataGridViewRow에 대해 액세스 가능한 개체를 새로 만듭니다.

CreateCells(DataGridView)

기존 셀을 지우고 제공된 DataGridView 템플릿에 따라 셀의 템플릿을 설정합니다.

CreateCells(DataGridView, Object[])

기존 셀을 지우고 셀 템플릿과 값을 설정합니다.

CreateCellsInstance()

이 행을 기반으로 셀의 새 컬렉션을 만듭니다.

Dispose()

DataGridViewBand에서 사용하는 모든 리소스를 해제합니다.

(다음에서 상속됨 DataGridViewBand)
Dispose(Boolean)

DataGridViewBand에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.

(다음에서 상속됨 DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

지정된 범위 주위에 포커스 영역을 그립니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetContextMenuStrip(Int32)

행의 바로 가기 메뉴를 가져옵니다.

GetErrorText(Int32)

지정된 인덱스의 행에 대한 오류 텍스트를 가져옵니다.

GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

지정된 조건에 따라 지정된 행의 이상적인 높이를 계산합니다.

GetState(Int32)

행의 현재 상태를 나타내는 값을 반환합니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

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

현재 Object의 단순 복사본을 만듭니다.

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

밴드가 다른 DataGridView에 연결될 때 호출됩니다.

(다음에서 상속됨 DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

현재 행을 그립니다.

PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

현재 행의 셀을 그립니다.

PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

현재 행의 머리글 셀을 그립니다.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
SetValues(Object[])

행의 셀 값을 설정합니다.

ToString()

행을 설명하는, 사람이 인식할 수 있는 문자열을 가져옵니다.

적용 대상

추가 정보