Поделиться через


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 управления . Строки можно получить с помощью коллекций Rows и SelectedRows элемента управления .

DataGridViewColumnВ отличие от , DataGridViewRow физически содержит коллекцию всех ячеек в этой строке. Доступ к этой коллекции можно получить через Cells свойство .

Класс DataGridViewRow используется для доступа к отдельным элементам ячейки, а также для настройки внешнего вида и поведения пользовательского интерфейса строки, например высоты и стиля ячейки. Как правило, все строки или большинство строк в элементе управления должны иметь одинаковые характеристики. Чтобы задать стили ячеек для всех строк в элементе управления , задайте свойства объекта , возвращаемого свойством DataGridView.RowsDefaultCellStyle . Чтобы задать стили для чередования строк, используйте DataGridView.AlternatingRowsDefaultCellStyle свойство . Дополнительные сведения о стилях ячеек см. в статье Стили ячеек элемента управления DataGridView в Windows Forms. Свойство также можно использовать для DataGridView.RowTemplate определения строки, которая будет использоваться в качестве основы для всех строк, добавленных в элемент управления .

Элемент DataGridView управления по возможности будет совместно использовать DataGridViewRow объекты в нескольких строках данных, чтобы избежать снижения производительности. Если вы не работаете с большими объемами данных и не испытываете проблем с производительностью, вы обычно можете игнорировать общий доступ к строкам. Общая строка обозначается значением Index свойства -1. Некоторые DataGridViewRow члены класса нельзя использовать с общими строками, но вы можете отменить общий доступ к строке, перейдя к ней DataGridViewRowCollection.Item[] через свойство . Строки также могут стать общими другими способами. Чтобы получить доступ к строке без ее просмотра, используйте DataGridViewRowCollection.SharedRow метод . При работе с большими объемами данных следует знать, как происходит совместное использование и отмена общего доступа к строкам, чтобы избежать снижения производительности. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

Примечания для тех, кто наследует этот метод

При наследовающем 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()

Возвращает понятно составленный текст, описывающий строку.

Применяется к

См. также раздел