DataGridViewRow Klasa

Definicja

Przedstawia wiersz w kontrolce 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
Dziedziczenie
Atrybuty

Przykłady

Poniższy przykład kodu ilustruje użycie tego typu.The following code example illustrates the use of this type. Ten przykład jest częścią większego przykładu dostępnego w instrukcje: manipulowanie wierszami w kontrolce DataGridView Windows Forms.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

Uwagi

Klasa DataGridViewRow reprezentuje wiersz w kontrolce DataGridView.The DataGridViewRow class represents a row in a DataGridView control. Wiersze można pobrać za pomocą kolekcji Rows i SelectedRows formantu.You can retrieve rows through the Rows and SelectedRows collections of the control.

W przeciwieństwie do DataGridViewColumn, DataGridViewRow fizycznie zawiera kolekcję wszystkich komórek w tym wierszu.Unlike a DataGridViewColumn, a DataGridViewRow physically contains a collection of all of the cells in that row. Dostęp do tej kolekcji można uzyskać za pomocą właściwości Cells.You can access this collection through the Cells property.

Klasa DataGridViewRow jest używana do uzyskiwania dostępu do poszczególnych elementów komórek, a także do dostosowywania wyglądu i zachowania interfejsu użytkownika wiersza (UI), takiego jak Height i style komórki.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. Zwykle wszystkie wiersze lub większość wierszy w kontrolce mogą mieć te same cechy.Typically, you will want all rows or most rows in the control to share the same characteristics. Aby ustawić style komórek dla wszystkich wierszy w kontrolce, ustaw właściwości obiektu zwróconego przez właściwość DataGridView.RowsDefaultCellStyle.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Aby ustawić style dla przemiennych wierszy, użyj właściwości DataGridView.AlternatingRowsDefaultCellStyle.To set styles for alternating rows, use the DataGridView.AlternatingRowsDefaultCellStyle property. Aby uzyskać więcej informacji na temat stylów komórek, zobacz style komórek w kontrolce DataGridView Windows Forms.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. Można również użyć właściwości DataGridView.RowTemplate, aby zdefiniować wiersz, który będzie używany jako podstawa dla wszystkich wierszy dodanych do formantu.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.

Formant DataGridView będzie współużytkować obiekty DataGridViewRow w wielu wierszach danych, o ile jest to możliwe, aby uniknąć kar za wydajność.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. Jeśli nie pracujesz z dużymi ilościami danych i występują problemy z wydajnością, zazwyczaj możesz zignorować udostępnianie wierszy.Unless you are working with large amounts of data and experiencing performance issues, you can typically ignore row sharing. Wiersz współużytkowany jest wskazywany przez Index wartość właściwości-1.A shared row is indicated by an Index property value of -1. Niektórych elementów członkowskich klasy DataGridViewRow nie można używać z udostępnionymi wierszami, ale można anulować udostępnianie wiersza, uzyskując do niego dostęp za pomocą właściwości 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. Wiersze mogą również być nieudostępniane w inny sposób.Rows can also become unshared in other ways. Aby uzyskać dostęp do wiersza bez jego udostępniania, użyj metody DataGridViewRowCollection.SharedRow.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. Podczas pracy z dużymi ilościami danych należy wiedzieć, jak wiersze są udostępniane i nie są udostępniane, aby uniknąć kar z zakresu wydajności.When working with large amounts of data, you should be aware of how rows are shared and unshared to avoid performance penalties. Aby uzyskać więcej informacji, zobacz najlepsze rozwiązania dotyczące skalowania Windows Forms formantu DataGridView.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Uwagi dotyczące dziedziczenia

Gdy dziedziczysz z DataGridViewRow i dodasz nowe właściwości do klasy pochodnej, pamiętaj, aby zastąpić metodę Clone(), aby skopiować nowe właściwości podczas klonowania operacji.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. Należy również wywołać metodę Clone() klasy bazowej, aby właściwości klasy bazowej były kopiowane do nowej komórki.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Konstruktory

DataGridViewRow()

Inicjuje nowe wystąpienie klasy DataGridViewRow bez użycia szablonu.Initializes a new instance of the DataGridViewRow class without using a template.

Właściwości

AccessibilityObject

Pobiera DataGridViewRow.DataGridViewRowAccessibleObject przypisane do DataGridViewRow.Gets the DataGridViewRow.DataGridViewRowAccessibleObject assigned to the DataGridViewRow.

Cells

Pobiera kolekcję komórek wypełniających wiersz.Gets the collection of cells that populate the row.

ContextMenuStrip

Pobiera lub ustawia menu skrótów dla wiersza.Gets or sets the shortcut menu for the row.

DataBoundItem

Pobiera obiekt powiązany z danymi, który wypełnił wiersz.Gets the data-bound object that populated the row.

DataGridView

DataGridView Pobiera kontrolkę skojarzoną z tym elementem.Gets the DataGridView control associated with this element.

(Odziedziczone po DataGridViewElement)
DefaultCellStyle

Pobiera lub ustawia domyślne style dla wiersza, które są używane do renderowania komórek w wierszu, chyba że style zostaną zastąpione.Gets or sets the default styles for the row, which are used to render cells in the row unless the styles are overridden.

DefaultHeaderCellType

Pobiera lub ustawia typ czasu wykonywania domyślnej komórki nagłówka.Gets or sets the run-time type of the default header cell.

(Odziedziczone po DataGridViewBand)
Displayed

Pobiera wartość wskazującą, czy ten wiersz jest wyświetlany na ekranie.Gets a value indicating whether this row is displayed on the screen.

DividerHeight

Pobiera lub ustawia wysokość linii podziału wiersza (w pikselach).Gets or sets the height, in pixels, of the row divider.

ErrorText

Pobiera lub ustawia tekst komunikatu o błędzie dla błędów na poziomie wiersza.Gets or sets the error message text for row-level errors.

Frozen

Pobiera lub ustawia wartość wskazującą, czy wiersz jest zablokowany.Gets or sets a value indicating whether the row is frozen.

HasDefaultCellStyle

Pobiera wartość wskazującą, DefaultCellStyle czy właściwość została ustawiona.Gets a value indicating whether the DefaultCellStyle property has been set.

(Odziedziczone po DataGridViewBand)
HeaderCell

Pobiera lub ustawia komórkę nagłówka wiersza.Gets or sets the row's header cell.

HeaderCellCore

Pobiera lub ustawia komórkę DataGridViewBandnagłówka.Gets or sets the header cell of the DataGridViewBand.

(Odziedziczone po DataGridViewBand)
Height

Pobiera lub ustawia bieżącą wysokość wiersza.Gets or sets the current height of the row.

Index

Pobiera względną pozycję pasma w DataGridView kontrolce.Gets the relative position of the band within the DataGridView control.

(Odziedziczone po DataGridViewBand)
InheritedStyle

Pobiera styl komórki obowiązujący dla wiersza.Gets the cell style in effect for the row.

IsNewRow

Pobiera wartość wskazującą, czy wiersz jest wierszem dla nowych rekordów.Gets a value indicating whether the row is the row for new records.

IsRow

Pobiera wartość wskazującą, czy pasmo reprezentuje wiersz.Gets a value indicating whether the band represents a row.

(Odziedziczone po DataGridViewBand)
MinimumHeight

Pobiera lub ustawia minimalną wysokość wiersza.Gets or sets the minimum height of the row.

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy wiersz jest tylko do odczytu.Gets or sets a value indicating whether the row is read-only.

Resizable

Pobiera lub ustawia wartość wskazującą, czy użytkownicy mogą zmieniać rozmiar wiersza lub wskazywać, że zachowanie jest dziedziczone z właściwości 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

Pobiera lub ustawia wartość wskazującą, czy wiersz jest zaznaczony.Gets or sets a value indicating whether the row is selected.

State

Pobiera bieżący stan wiersza.Gets the current state of the row.

Tag

Pobiera lub ustawia obiekt, który zawiera dane do skojarzenia z pasmem.Gets or sets the object that contains data to associate with the band.

(Odziedziczone po DataGridViewBand)
Visible

Pobiera lub ustawia wartość wskazującą, czy wiersz jest widoczny.Gets or sets a value indicating whether the row is visible.

Metody

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

Modyfikuje styl obramowania nagłówka wiersza wejściowego zgodnie z określonymi kryteriami.Modifies an input row header border style according to the specified criteria.

Clone()

Tworzy dokładną kopię tego wiersza.Creates an exact copy of this row.

CreateAccessibilityInstance()

Tworzy nowy dostępny obiekt dla DataGridViewRow.Creates a new accessible object for the DataGridViewRow.

CreateCells(DataGridView)

Czyści istniejące komórki i ustawia ich szablon zgodnie z podanym szablonem DataGridView.Clears the existing cells and sets their template according to the supplied DataGridView template.

CreateCells(DataGridView, Object[])

Czyści istniejące komórki i ustawia ich szablon i wartości.Clears the existing cells and sets their template and values.

CreateCellsInstance()

Tworzy nową kolekcję komórek na podstawie tego wiersza.Constructs a new collection of cells based on this row.

Dispose()

Zwalnia wszystkie zasoby używane przez DataGridViewBandprogram.Releases all resources used by the DataGridViewBand.

(Odziedziczone po DataGridViewBand)
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez DataGridViewBand program i opcjonalnie zwalnia zarządzane zasoby.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Odziedziczone po DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Rysuje prostokąt fokusu wokół określonych granic.Draws a focus rectangle around the specified bounds.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetContextMenuStrip(Int32)

Pobiera menu skrótów dla wiersza.Gets the shortcut menu for the row.

GetErrorText(Int32)

Pobiera tekst błędu dla wiersza o określonym indeksie.Gets the error text for the row at the specified index.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Oblicza idealną wysokość określonego wiersza na podstawie określonych kryteriów.Calculates the ideal height of the specified row based on the specified criteria.

GetState(Int32)

Zwraca wartość wskazującą bieżący stan wiersza.Returns a value indicating the current state of the row.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnDataGridViewChanged()

Wywoływana, gdy pasek jest skojarzony z innym DataGridView.Called when the band is associated with a different DataGridView.

(Odziedziczone po DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Maluje bieżący wiersz.Paints the current row.

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

Maluje komórki w bieżącym wierszu.Paints the cells in the current row.

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

Maluje komórkę nagłówka bieżącego wiersza.Paints the header cell of the current row.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick Podnosi zdarzenie.Raises the CellClick event.

(Odziedziczone po DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick Podnosi zdarzenie.Raises the CellContentClick event.

(Odziedziczone po DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick Podnosi zdarzenie.Raises the CellContentDoubleClick event.

(Odziedziczone po DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged Podnosi zdarzenie.Raises the CellValueChanged event.

(Odziedziczone po DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError Podnosi zdarzenie.Raises the DataError event.

(Odziedziczone po DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel Podnosi zdarzenie.Raises the MouseWheel event.

(Odziedziczone po DataGridViewElement)
SetValues(Object[])

Ustawia wartości komórek wiersza.Sets the values of the row's cells.

ToString()

Pobiera ciąg czytelny dla człowieka, który opisuje wiersz.Gets a human-readable string that describes the row.

Dotyczy

Zobacz też