DataGridViewCell.Value Vlastnost

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

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í.

Získá nebo nastaví hodnotu přidruženou k této buňce.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public object Value { get; set; }

[System.ComponentModel.Browsable(false)]
public object? Value { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Value : obj with get, set

Public Property Value As Object

Hodnota vlastnosti

Object

Získá nebo nastaví data, která mají být zobrazena buňkou. Výchozí formát je null.

Atributy: BrowsableAttribute

Výjimky

ArgumentOutOfRangeException

RowIndex je mimo platný rozsah 0 na počet řádků v ovládacím prvku minus 1.

InvalidOperationException

ColumnIndex je menší než 0, což znamená, že buňka je buňka záhlaví řádku.

Příklady

Následující příklad kódu ukazuje, jak aktualizovat obsah buňky pomocí Value vlastnosti . Tento příklad je součástí většího příkladu kódu, který je uveden v části Postupy: Manipulace s řádky v ovládacím prvku model Windows Forms DataGridView.

// Give cheescake excellent rating.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   UpdateStars( dataGridView->Rows[ 4 ], L"******************" );
}

int ratingColumn;
void UpdateStars( DataGridViewRow^ row, String^ stars )
{
   row->Cells[ ratingColumn ]->Value = stars;
   
   // Resize the column width to account for the new value.
   row->DataGridView->AutoResizeColumn( ratingColumn, DataGridViewAutoSizeColumnMode::DisplayedCells );
}

// Give cheescake excellent rating.
private void Button8_Click(object sender,
    System.EventArgs e)
{
    UpdateStars(dataGridView.Rows[4], "******************");
}

int ratingColumn = 3;

private void UpdateStars(DataGridViewRow row, string stars)
{

    row.Cells[ratingColumn].Value = stars;

    // Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, 
        DataGridViewAutoSizeColumnMode.DisplayedCells);
}

' Give cheescake excellent rating.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    UpdateStars(dataGridView.Rows(4), "******************")
End Sub

Private ratingColumn As Integer = 3

Private Sub UpdateStars(ByVal row As DataGridViewRow, _
    ByVal stars As String)

    row.Cells(ratingColumn).Value = stars

    ' Resize the column width to account for the new value.
    row.DataGridView.AutoResizeColumn(ratingColumn, _
        DataGridViewAutoSizeColumnMode.DisplayedCells)

End Sub

Poznámky

Když k buňce přiřadíte jinou hodnotu, CellValueChanged vyvolá se událost DataGridView ovládacího prvku.

Vlastnost Value je skutečný datový objekt obsažený v buňce, zatímco FormattedValue vlastnost je formátovaná reprezentace dat. Vlastnosti ValueType a FormattedValueType odpovídají datovým typům těchto hodnot.

Při nastavení Value vlastnosti se zadaná hodnota automaticky nepřevedá z formátované zobrazované hodnoty na základní hodnotu buňky. Například hodnota, která DataGridViewCellStyle je pro buňku účinná, je ignorována, takže nastavení Value na DataGridViewCellStyle.NullValue hodnotu nemá za následek hodnotu DataGridViewCellStyle.DataSourceNullValuevlastnosti .

Platí pro