DataGridViewRow Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object

DataGridViewElement

DataGridViewBand
DataGridViewRow

Atrybuty: TypeConverterAttribute

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

Udostępnij za pośrednictwem