Sdílet prostřednictvím


DataGridViewRow Třída

Definice

Představuje řádek v ovládacím prvku 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
Dědičnost
Atributy

Příklady

Následující příklad kódu ukazuje použití tohoto typu. Tento příklad je součástí většího příkladu, který je k dispozici v tématu Postupy: Manipulace s řádky v ovládacím prvku model 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

Poznámky

Třída DataGridViewRow představuje řádek v ovládacím DataGridView prvku. Řádky můžete načítat prostřednictvím Rows kolekcí a SelectedRows ovládacího prvku.

Na rozdíl od objektu DataGridViewColumnobsahuje DataGridViewRow objekt fyzicky kolekci všech buněk v daném řádku. K této kolekci můžete přistupovat Cells prostřednictvím vlastnosti .

Třída DataGridViewRow se používá pro přístup k jednotlivým prvkům buňky a také k úpravě vzhledu a chování uživatelského rozhraní řádku, jako je výška a styl buňky. Obvykle chcete, aby všechny řádky nebo většina řádků v ovládacím prvku sdílela stejné vlastnosti. Chcete-li nastavit styly buněk pro všechny řádky v ovládacím prvku, nastavte vlastnosti objektu vráceného DataGridView.RowsDefaultCellStyle vlastností . Pokud chcete nastavit styly pro střídavé řádky, použijte DataGridView.AlternatingRowsDefaultCellStyle vlastnost . Další informace o stylech buněk naleznete v tématu Styly buňky v ovládacím prvku model Windows Forms DataGridView. Vlastnost můžete použít také DataGridView.RowTemplate k definování řádku, který bude použit jako základ pro všechny řádky přidané do ovládacího prvku.

Ovládací DataGridView prvek bude sdílet DataGridViewRow objekty mezi více řádky dat, kdykoli je to možné, aby se zabránilo snížení výkonu. Pokud nepracujete s velkými objemy dat a nedochází k problémům s výkonem, můžete sdílení řádků obvykle ignorovat. Sdílený řádek je označen Index hodnotou vlastnosti -1. Některé členy DataGridViewRow třídy nelze použít se sdílenými řádky, ale sdílení řádku můžete zrušit tak, že k němu budete přistupovat prostřednictvím DataGridViewRowCollection.Item[] vlastnosti . Řádky se můžou zrušit i jinými způsoby. Pokud chcete získat přístup k řádku bez zrušení sdílení, použijte metodu DataGridViewRowCollection.SharedRow . Při práci s velkými objemy dat byste měli vědět, jak se řádky sdílejí a nesdílejí, abyste se vyhnuli postihům za výkon. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Poznámky pro dědice

Když odvozujete a DataGridViewRow přidáte nové vlastnosti do odvozené třídy, nezapomeňte přepsat metodu Clone() pro zkopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() , aby se vlastnosti základní třídy zkopírovaly do nové buňky.

Konstruktory

DataGridViewRow()

Inicializuje novou instanci DataGridViewRow třídy bez použití šablony.

Vlastnosti

AccessibilityObject

Získá přiřazené DataGridViewRow.DataGridViewRowAccessibleObject k DataGridViewRow.

Cells

Získá kolekci buněk, které naplní řádek.

ContextMenuStrip

Získá nebo nastaví místní nabídku pro řádek.

DataBoundItem

Získá objekt vázaný na data, který naplnil řádek.

DataGridView

DataGridView Získá ovládací prvek přidružený k tomuto prvku.

(Zděděno od DataGridViewElement)
DefaultCellStyle

Získá nebo nastaví výchozí styly pro řádek, které se používají k vykreslení buněk v řádku, pokud styly jsou přepsány.

DefaultHeaderCellType

Získá nebo nastaví typ za běhu výchozí buňky záhlaví.

(Zděděno od DataGridViewBand)
Displayed

Získá hodnotu označující, zda je tento řádek zobrazen na obrazovce.

DividerHeight

Získá nebo nastaví výšku oddělovače řádků v pixelech.

ErrorText

Získá nebo nastaví text chybové zprávy pro chyby na úrovni řádků.

Frozen

Získá nebo nastaví hodnotu označující, zda je řádek ukotven.

HasDefaultCellStyle

Získá hodnotu označující, zda DefaultCellStyle byla nastavena vlastnost.

(Zděděno od DataGridViewBand)
HeaderCell

Získá nebo nastaví buňku záhlaví řádku.

HeaderCellCore

Získá nebo nastaví buňku záhlaví objektu DataGridViewBand.

(Zděděno od DataGridViewBand)
Height

Získá nebo nastaví aktuální výšku řádku.

Index

Získá relativní pozici pásma v rámci DataGridView ovládacího prvku.

(Zděděno od DataGridViewBand)
InheritedStyle

Získá styl buňky v efektu pro řádek.

IsNewRow

Získá hodnotu označující, zda řádek je řádek pro nové záznamy.

IsRow

Získá hodnotu označující, zda pásmo představuje řádek.

(Zděděno od DataGridViewBand)
MinimumHeight

Získá nebo nastaví minimální výšku řádku.

ReadOnly

Získá nebo nastaví hodnotu označující, zda je řádek jen pro čtení.

Resizable

Získá nebo nastaví hodnotu označující, zda uživatelé mohou změnit velikost řádku nebo indikuje, že chování je zděděno z AllowUserToResizeRows vlastnosti.

Selected

Získá nebo nastaví hodnotu označující, zda je vybrán řádek.

State

Získá aktuální stav řádku.

Tag

Získá nebo nastaví objekt, který obsahuje data, která chcete přidružit k pásu.

(Zděděno od DataGridViewBand)
Visible

Získá nebo nastaví hodnotu označující, zda je řádek viditelný.

Metody

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

Upraví styl ohraničení záhlaví vstupního řádku podle zadaných kritérií.

Clone()

Vytvoří přesnou kopii tohoto řádku.

CreateAccessibilityInstance()

Vytvoří nový přístupný objekt pro DataGridViewRowobjekt .

CreateCells(DataGridView)

Vymaže existující buňky a nastaví jejich šablonu podle zadané DataGridView šablony.

CreateCells(DataGridView, Object[])

Vymaže existující buňky a nastaví jejich šablonu a hodnoty.

CreateCellsInstance()

Vytvoří novou kolekci buněk na základě tohoto řádku.

Dispose()

Uvolní všechny prostředky používané nástrojem DataGridViewBand.

(Zděděno od DataGridViewBand)
Dispose(Boolean)

Uvolní nespravované prostředky používané nástrojem DataGridViewBand a volitelně uvolní spravované prostředky.

(Zděděno od DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Nakreslí obdélník fokusu kolem zadaných hranic.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetContextMenuStrip(Int32)

Získá místní nabídku pro řádek.

GetErrorText(Int32)

Získá text chyby pro řádek v zadaném indexu.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Vypočítá ideální výšku zadaného řádku na základě zadaných kritérií.

GetState(Int32)

Vrátí hodnotu označující aktuální stav řádku.

GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
OnDataGridViewChanged()

Volá se, když je skupina přidružená k jinému DataGridView.

(Zděděno od DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Vykreslí aktuální řádek.

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

Vykreslí buňky v aktuálním řádku.

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

Vykreslí buňku záhlaví aktuálního řádku.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick Vyvolá událost.

(Zděděno od DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick Vyvolá událost.

(Zděděno od DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick Vyvolá událost.

(Zděděno od DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged Vyvolá událost.

(Zděděno od DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError Vyvolá událost.

(Zděděno od DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel Vyvolá událost.

(Zděděno od DataGridViewElement)
SetValues(Object[])

Nastaví hodnoty buněk řádku.

ToString()

Získá čitelný řetězec, který popisuje řádek.

Platí pro

Viz také