DataGridViewRow Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Примеры

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

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

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