DataGridViewRow Класс

Определение

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

Примеры

В следующем примере кода показано использование этого типа. Этот пример является частью более крупного примера, доступного в разделе Практическое руководство. Управление строками в элементе управления 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() , чтобы свойства базового класса копировались в новую ячейку.

Конструкторы

Свойства

Методы

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

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

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