DataGridViewRow Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewRow.cs

Представляет строку в элементе 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

Наследование

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Атрибуты

TypeConverterAttribute

Примеры

В следующем примере кода показано использование этого типа. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Управление строками в элементе управления DataGridView в Windows Forms".

// 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, Object[])	Очищает существующие ячейки и задает их шаблон и значения.
CreateCells(DataGridView)	Очищает существующие ячейки и задает их шаблон в соответствии с предоставленным DataGridView шаблоном.
CreateCellsInstance()	Создает новую коллекцию ячеек на основе этой строки.
Dispose()	Освобождает все ресурсы, используемые параметром DataGridViewBand. (Унаследовано от DataGridViewBand)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DataGridViewBand и при необходимости освобождает управляемые ресурсы. (Унаследовано от DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Рисует прямоугольник фокуса вокруг указанных границ.
GetContextMenuStrip(Int32)	Возвращает контекстное меню для строки.
GetErrorText(Int32)	Возвращает текст ошибки для строки по указанному индексу.
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Вычисляет идеальную высоту указанной строки на основе указанных критериев.
GetState(Int32)	Возвращает значение, указывающее текущее состояние строки.
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()	Возвращает удобочитаемую пользователем строку, описывающую строку.

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

• DataGridView
• DataGridViewColumn
• Clone()
• Рекомендации по масштабированию элемента управления DataGridView в Windows Forms
• Стили ячеек в элементе управления DataGridView в Windows Forms