DataGridViewRow Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 DataGridViewBandPublic 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ý. |
