DataGridViewRow Класс

Определение

Представляет строку в элементе управления DataGridView.Represents a row in a DataGridView control.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand
type DataGridViewRow = class
    inherit DataGridViewBand
Public Class DataGridViewRow
Inherits DataGridViewBand
Наследование
Атрибуты

Примеры

В следующем примере кода показано использование этого типа.The following code example illustrates the use of this type. Этот пример является частью большого примера, доступного в How: Обработка строк в элементе управления Windows Forms DataGridView.This example is part of a larger example available in How to: Manipulate Rows in the Windows Forms DataGridView Control.

// 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.The DataGridViewRow class represents a row in a DataGridView control. Строки можно получить с помощью коллекций Rows и SelectedRows элемента управления.You can retrieve rows through the Rows and SelectedRows collections of the control.

В отличие от DataGridViewColumn, DataGridViewRow физически содержит коллекцию всех ячеек в этой строке.Unlike a DataGridViewColumn, a DataGridViewRow physically contains a collection of all of the cells in that row. Доступ к этой коллекции можно получить с помощью свойства Cells.You can access this collection through the Cells property.

Класс DataGridViewRow используется для доступа к отдельным элементам ячейки, а также для настройки внешнего вида и поведения пользовательского интерфейса строки, например высоты и стиля ячейки.The DataGridViewRow class is used to access the individual cell elements, as well as to adjust the appearance and behavior of the row user interface (UI), such as height and cell style. Как правило, все строки или большинство строк в элементе управления должны иметь одинаковые характеристики.Typically, you will want all rows or most rows in the control to share the same characteristics. Чтобы задать стили ячеек для всех строк в элементе управления, задайте свойства объекта, возвращаемого свойством DataGridView.RowsDefaultCellStyle.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Чтобы задать стили для чередующихся строк, используйте свойство DataGridView.AlternatingRowsDefaultCellStyle.To set styles for alternating rows, use the DataGridView.AlternatingRowsDefaultCellStyle property. Дополнительные сведения о стилях ячеек см. в разделе Стили ячеек в элементе управления Windows Forms DataGridView.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. Можно также использовать свойство DataGridView.RowTemplate, чтобы определить строку, которая будет использоваться в качестве базиса для всех строк, добавляемых в элемент управления.You can also use the DataGridView.RowTemplate property to define a row that will be used as a basis for all rows added to the control.

Элемент управления DataGridView будет совместно использовать DataGridViewRow объекты в нескольких строках данных, чтобы избежать снижения производительности.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. Если вы не работаете с большими объемами данных и испытываете проблемы с производительностью, обычно можно пропустить общий доступ к строкам.Unless you are working with large amounts of data and experiencing performance issues, you can typically ignore row sharing. Общая строка обозначается значением свойства Index, равным-1.A shared row is indicated by an Index property value of -1. Некоторые члены класса DataGridViewRow не могут использоваться с общими строками, но можно отменить общий доступ к строке, обратившись к ней через свойство DataGridViewRowCollection.Item[Int32].Some members of the DataGridViewRow class cannot be used with shared rows, but you can unshare a row by accessing it through the DataGridViewRowCollection.Item[Int32] property. Строки также могут быть отличных от общего доступа другими способами.Rows can also become unshared in other ways. Чтобы получить доступ к строке, не отменяя общий доступ к ней, используйте метод DataGridViewRowCollection.SharedRow.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. При работе с большими объемами данных следует иметь в виду, как совместно используются и отменяются совместное использование строк во избежание снижения производительности.When working with large amounts of data, you should be aware of how rows are shared and unshared to avoid performance penalties. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

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

При наследовании от DataGridViewRow и добавлении новых свойств в производный класс обязательно Переопределите метод Clone(), чтобы скопировать новые свойства во время операций клонирования.When you derive from DataGridViewRow and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Также следует вызвать метод Clone() базового класса, чтобы свойства базового класса копировались в новую ячейку.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

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

DataGridViewRow()

Инициализирует новый экземпляр класса DataGridViewRow без использования шаблона.Initializes a new instance of the DataGridViewRow class without using a template.

Свойства

AccessibilityObject

Получает значение DataGridViewRow.DataGridViewRowAccessibleObject, присвоенное объекту DataGridViewRow.Gets the DataGridViewRow.DataGridViewRowAccessibleObject assigned to the DataGridViewRow.

Cells

Возвращает коллекцию ячеек, заполняющих строку.Gets the collection of cells that populate the row.

ContextMenuStrip

Возвращает или задает контекстное меню для строки.Gets or sets the shortcut menu for the row.

DataBoundItem

Возвращает связанный с данными объект, наполнивший строку.Gets the data-bound object that populated the row.

DataGridView

Получает элемент управления DataGridView, связанный с данным элементом.Gets the DataGridView control associated with this element.

(Унаследовано от DataGridViewElement)
DefaultCellStyle

Возвращает или задает стили по умолчанию для строки, которые используются для визуализации ячеек в строке, если стили не переопределены.Gets or sets the default styles for the row, which are used to render cells in the row unless the styles are overridden.

DefaultHeaderCellType

Получает или задает тип времени выполнения для ячейки заголовка по умолчанию.Gets or sets the run-time type of the default header cell.

(Унаследовано от DataGridViewBand)
Displayed

Возвращает значение, указывающее, отображается ли данная строка на экране.Gets a value indicating whether this row is displayed on the screen.

DividerHeight

Получает или задает высоту (в пикселях) разделителя строки.Gets or sets the height, in pixels, of the row divider.

ErrorText

Возвращает или задает текст сообщения об ошибке для ошибок уровня строки.Gets or sets the error message text for row-level errors.

Frozen

Возвращает или задает значение, показывающее, является ли строка замороженной.Gets or sets a value indicating whether the row is frozen.

HasDefaultCellStyle

Получает значение, показывающее, было ли установлено свойство DefaultCellStyle.Gets a value indicating whether the DefaultCellStyle property has been set.

(Унаследовано от DataGridViewBand)
HeaderCell

Возвращает или задает ячейку заголовка строки.Gets or sets the row's header cell.

HeaderCellCore

Получает или задает ячейку заголовка объекта DataGridViewBand.Gets or sets the header cell of the DataGridViewBand.

(Унаследовано от DataGridViewBand)
Height

Возвращает или задает текущую высоту строки.Gets or sets the current height of the row.

Index

Получает относительную позицию диапазона в элементе управления DataGridView.Gets the relative position of the band within the DataGridView control.

(Унаследовано от DataGridViewBand)
InheritedStyle

Возвращает стиль ячейки, действующий в текущий момент для строки.Gets the cell style in effect for the row.

IsNewRow

Возвращает значение, указывающее, является ли строка строкой для новых записей.Gets a value indicating whether the row is the row for new records.

IsRow

Получает значение, показывающее, представляет ли диапазон строку.Gets a value indicating whether the band represents a row.

(Унаследовано от DataGridViewBand)
MinimumHeight

Получает или задает минимальную высоту строки.Gets or sets the minimum height of the row.

ReadOnly

Возвращает или задает значение, указывающее, является ли строка доступной только для чтения.Gets or sets a value indicating whether the row is read-only.

Resizable

Возвращает или задает значение, указывающее, могут ли пользователи изменять размер строки. Также может указывать, унаследовано ли поведение от AllowUserToResizeRows.Gets or sets a value indicating whether users can resize the row or indicating that the behavior is inherited from the AllowUserToResizeRows property.

Selected

Получает или задает значение, указывающее, выбрана ли строка.Gets or sets a value indicating whether the row is selected.

State

Возвращает текущее состояние строки.Gets the current state of the row.

Tag

Получает или задает объект, содержащий данные, связанные с диапазоном.Gets or sets the object that contains data to associate with the band.

(Унаследовано от DataGridViewBand)
Visible

Возвращает или задает значение, показывающее, является ли строка видимой.Gets or sets a value indicating whether the row is visible.

Методы

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

Изменяет стиль границы заголовка входной строки в соответствии с указанными критериями.Modifies an input row header border style according to the specified criteria.

Clone()

Создает точную копию данной строки.Creates an exact copy of this row.

CreateAccessibilityInstance()

Создает новый доступный объект для DataGridViewRow.Creates a new accessible object for the DataGridViewRow.

CreateCells(DataGridView)

Очищает существующие ячейки и задает их шаблон в соответствии с предоставленным шаблоном DataGridView.Clears the existing cells and sets their template according to the supplied DataGridView template.

CreateCells(DataGridView, Object[])

Очищает существующие ячейки и задает их шаблон и значения.Clears the existing cells and sets their template and values.

CreateCellsInstance()

Создает новую коллекцию ячеек на основе данной строки.Constructs a new collection of cells based on this row.

Dispose()

Освобождает все ресурсы, занятые модулем DataGridViewBand.Releases all resources used by the DataGridViewBand.

(Унаследовано от DataGridViewBand)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DataGridViewBand, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Унаследовано от DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Отрисовывает прямоугольник фокуса вокруг указанных границ.Draws a focus rectangle around the specified bounds.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetContextMenuStrip(Int32)

Возвращает контекстное меню для строки.Gets the shortcut menu for the row.

GetErrorText(Int32)

Возвращает текст ошибки для строки, находящейся по указанному индексу.Gets the error text for the row at the specified index.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Вычисляет идеальную высоту указанной строки, исходя из заданных критериев.Calculates the ideal height of the specified row based on the specified criteria.

GetState(Int32)

Возвращает значение, указывающее текущее состояние строки.Returns a value indicating the current state of the row.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnDataGridViewChanged()

Вызывается, когда диапазон связан с другим элементом управления DataGridView.Called when the band is associated with a different DataGridView.

(Унаследовано от DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Закрашивает текущую строку.Paints the current row.

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

Закрашивает ячейки в текущей строке.Paints the cells in the current row.

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

Закрашивает ячейку заголовка текущей строки.Paints the header cell of the current row.

RaiseCellClick(DataGridViewCellEventArgs)

Вызывает событие CellClick.Raises the CellClick event.

(Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Вызывает событие CellContentClick.Raises the CellContentClick event.

(Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Вызывает событие CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Вызывает событие CellValueChanged.Raises the CellValueChanged event.

(Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Вызывает событие DataError.Raises the DataError event.

(Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Создает событие MouseWheel.Raises the MouseWheel event.

(Унаследовано от DataGridViewElement)
SetValues(Object[])

Задает значения ячеек строки.Sets the values of the row's cells.

ToString()

Получает легко читаемую пользователем строку, описывающую строку.Gets a human-readable string that describes the row.

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

Дополнительно