DataGridViewRow Klasa

Definicja

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

Przykłady

Poniższy przykład kodu ilustruje użycie tego typu. Ten przykład jest częścią większego przykładu dostępnego w temacie How to: Manipulate Rows in the Windows Forms DataGridView Control (Jak manipulować wierszami w kontrolce 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

Uwagi

Klasa DataGridViewRow reprezentuje wiersz w kontrolce DataGridView . Wiersze można pobrać za pomocą Rows kolekcji i SelectedRows kontrolki .

W przeciwieństwie do elementu DataGridViewColumn, DataGridViewRow fizycznie zawiera kolekcję wszystkich komórek w tym wierszu. Dostęp do tej kolekcji można uzyskać za pośrednictwem Cells właściwości .

Klasa DataGridViewRow służy do uzyskiwania dostępu do poszczególnych elementów komórek, a także do dostosowywania wyglądu i zachowania interfejsu użytkownika wiersza, takiego jak wysokość i styl komórki. Zazwyczaj wszystkie wiersze lub większość wierszy w kontrolce powinny mieć takie same cechy. Aby ustawić style komórek dla wszystkich wierszy w kontrolce, ustaw właściwości obiektu zwracanego przez DataGridView.RowsDefaultCellStyle właściwość . Aby ustawić style dla przemiennych wierszy, użyj DataGridView.AlternatingRowsDefaultCellStyle właściwości . Aby uzyskać więcej informacji na temat stylów komórek, zobacz Style komórek w kontrolce DataGridView Windows Forms. Możesz również użyć DataGridView.RowTemplate właściwości , aby zdefiniować wiersz, który będzie używany jako podstawa dla wszystkich wierszy dodanych do kontrolki.

Kontrolka DataGridView będzie udostępniać DataGridViewRow obiekty w wielu wierszach danych, gdy jest to możliwe, aby uniknąć kar za wydajność. Jeśli nie pracujesz z dużą ilością danych i występują problemy z wydajnością, zazwyczaj można zignorować udostępnianie wierszy. Współużytkowany wiersz jest wskazywany Index przez wartość właściwości -1. Niektórych składowych DataGridViewRow klasy nie można używać z udostępnionymi wierszami, ale można anulować udostępnianie wiersza, korzystając z niej za pośrednictwem DataGridViewRowCollection.Item[] właściwości . Wiersze mogą również stać się nieudostępniane na inne sposoby. Aby uzyskać dostęp do wiersza bez udostępniania go, użyj DataGridViewRowCollection.SharedRow metody . Podczas pracy z dużą ilością danych należy pamiętać, jak wiersze są udostępniane i nieudostępniane, aby uniknąć kar za wydajność. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView).

Uwagi dotyczące dziedziczenia

Po utworzeniu i DataGridViewRow dodaniu nowych właściwości do klasy pochodnej pamiętaj, aby zastąpić metodę Clone() , aby skopiować nowe właściwości podczas operacji klonowania. Należy również wywołać metodę klasy Clone() bazowej, aby właściwości klasy bazowej zostały skopiowane do nowej komórki.

Konstruktory

DataGridViewRow()

Inicjuje DataGridViewRow nowe wystąpienie klasy bez użycia szablonu.

Właściwości

AccessibilityObject

Pobiera element DataGridViewRow.DataGridViewRowAccessibleObject przypisany do .DataGridViewRow

Cells

Pobiera kolekcję komórek, które wypełniają wiersz.

ContextMenuStrip

Pobiera lub ustawia menu skrótów dla wiersza.

DataBoundItem

Pobiera obiekt powiązany z danymi, który wypełnił wiersz.

DataGridView

DataGridView Pobiera formant skojarzony z tym elementem.

(Odziedziczone po DataGridViewElement)
DefaultCellStyle

Pobiera lub ustawia domyślne style wiersza, które są używane do renderowania komórek w wierszu, chyba że style są zastępowane.

DefaultHeaderCellType

Pobiera lub ustawia typ czasu wykonywania domyślnej komórki nagłówka.

(Odziedziczone po DataGridViewBand)
Displayed

Pobiera wartość wskazującą, czy ten wiersz jest wyświetlany na ekranie.

DividerHeight

Pobiera lub ustawia wysokość w pikselach dzielenia wierszy.

ErrorText

Pobiera lub ustawia tekst komunikatu o błędzie dla błędów na poziomie wiersza.

Frozen

Pobiera lub ustawia wartość wskazującą, czy wiersz jest zamrożony.

HasDefaultCellStyle

Pobiera wartość wskazującą DefaultCellStyle , czy właściwość została ustawiona.

(Odziedziczone po DataGridViewBand)
HeaderCell

Pobiera lub ustawia komórkę nagłówka wiersza.

HeaderCellCore

Pobiera lub ustawia komórkę nagłówka obiektu DataGridViewBand.

(Odziedziczone po DataGridViewBand)
Height

Pobiera lub ustawia bieżącą wysokość wiersza.

Index

Pobiera względną pozycję pasma w kontrolce DataGridView .

(Odziedziczone po DataGridViewBand)
InheritedStyle

Pobiera styl komórki w efekcie dla wiersza.

IsNewRow

Pobiera wartość wskazującą, czy wiersz jest wierszem dla nowych rekordów.

IsRow

Pobiera wartość wskazującą, czy przedział reprezentuje wiersz.

(Odziedziczone po DataGridViewBand)
MinimumHeight

Pobiera lub ustawia minimalną wysokość wiersza.

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy wiersz jest tylko do odczytu.

Resizable

Pobiera lub ustawia wartość wskazującą, czy użytkownicy mogą zmienić rozmiar wiersza lub wskazać, że zachowanie jest dziedziczone z AllowUserToResizeRows właściwości.

Selected

Pobiera lub ustawia wartość wskazującą, czy wiersz jest zaznaczony.

State

Pobiera bieżący stan wiersza.

Tag

Pobiera lub ustawia obiekt zawierający dane do skojarzenia z pasmem.

(Odziedziczone po DataGridViewBand)
Visible

Pobiera lub ustawia wartość wskazującą, czy wiersz jest widoczny.

Metody

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

Modyfikuje styl obramowania nagłówka wiersza wejściowego zgodnie z określonymi kryteriami.

Clone()

Tworzy dokładną kopię tego wiersza.

CreateAccessibilityInstance()

Tworzy nowy dostępny obiekt dla obiektu DataGridViewRow.

CreateCells(DataGridView)

Czyści istniejące komórki i ustawia szablon zgodnie z podanym DataGridView szablonem.

CreateCells(DataGridView, Object[])

Czyści istniejące komórki i ustawia ich szablon i wartości.

CreateCellsInstance()

Tworzy nową kolekcję komórek na podstawie tego wiersza.

Dispose()

Zwalnia wszelkie zasoby używane przez element DataGridViewBand.

(Odziedziczone po DataGridViewBand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DataGridViewBand i opcjonalnie zwalnia zasoby zarządzane.

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

Rysuje prostokąt fokusu wokół określonych granic.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetContextMenuStrip(Int32)

Pobiera menu skrótów dla wiersza.

GetErrorText(Int32)

Pobiera tekst błędu dla wiersza w określonym indeksie.

GetHashCode()

Służy jako domyślna funkcja skrótu.

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

Oblicza idealną wysokość określonego wiersza na podstawie określonych kryteriów.

GetState(Int32)

Zwraca wartość wskazującą bieżący stan wiersza.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnDataGridViewChanged()

Wywoływana, gdy zespół jest skojarzony z innym DataGridViewelementem .

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

Maluje bieżący wiersz.

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

Maluje komórki w bieżącym wierszu.

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

Maluje komórkę nagłówka bieżącego wiersza.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
SetValues(Object[])

Ustawia wartości komórek wiersza.

ToString()

Pobiera czytelny dla człowieka ciąg opisujący wiersz.

Dotyczy

Zobacz też