DataGridViewCellStyle.NullValue Vlastnost
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í.
Získá nebo nastaví DataGridView hodnotu zobrazení buňky odpovídající hodnotě Value buňky nebo null.
public:
property System::Object ^ NullValue { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object NullValue { get; set; }[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object? NullValue { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, setPublic Property NullValue As ObjectHodnota vlastnosti
Objekt použitý k označení hodnoty null v buňce. Výchozí hodnota je Empty.
- Atributy
Příklady
Následující příklad kódu ilustruje použití této vlastnosti. V tomto příkladu obslužná DataGridView.CellFormatting rutina události zobrazí hodnotu NullValue vlastnosti, když se hodnota buňky rovná DataSourceNullValue.
// Display NullValue for cell values equal to DataSourceNullValue.
private void dataGridView1_CellFormatting(object sender,
DataGridViewCellFormattingEventArgs e)
{
String value = e.Value as string;
if ((value != null) && value.Equals(e.CellStyle.DataSourceNullValue))
{
e.Value = e.CellStyle.NullValue;
e.FormattingApplied = true;
}
}
' Display NullValue for cell values equal to DataSourceNullValue.
Private Sub dataGridView1_CellFormatting(ByVal sender As Object, _
ByVal e As DataGridViewCellFormattingEventArgs) _
Handles dataGridView1.CellFormatting
Dim value As String = TryCast(e.Value, String)
If value IsNot Nothing And _
value.Equals(e.CellStyle.DataSourceNullValue) Then
e.Value = e.CellStyle.NullValue
e.FormattingApplied = True
End If
End Sub
Poznámky
DataGridView Pokud má buňka s tímto stylem buňky hodnotu DBNull.Value nebo null uživatel buňku upraví a stiskne ctrl+0, DataGridView zobrazí NullValue ovládací prvek hodnotu vlastnosti. Když uživatel upraví buňku s tímto stylem buňky a zadá hodnotu této vlastnosti nebo stiskne kombinaci kláves CTRL+0, nastaví ovládací prvek hodnotu buňky na hodnotu DataSourceNullValue vlastnosti nebo null pokud DataSourceNullValue je DBNull.Value a buňka ValueType je typ odkazu. K tomuto převodu nedojde při programovém DataGridViewCell.Value nastavení vlastnosti.
Note
Ovládací prvek nezobrazuje NullValue hodnotu vlastnosti pro hodnoty buněk, které DataSourceNullValue se rovnají hodnotě vlastnosti, pokud DataSourceNullValue je nastavena na jinou hodnotu než DBNull.Value nebo null. V tomto případě můžete zpracovat DataGridView.CellFormatting událost, která zobrazí NullValue hodnotu vlastnosti. Další informace najdete v příkladu kódu v tomto tématu.
Tato vlastnost přebírá libovolný objekt, který umožňuje zadat hodnotu s typem odpovídajícím typu zobrazení buňky. Tuto vlastnost můžete například nastavit na řetězcové hodnoty pro použití podle buněk textového pole nebo obrázků pro použití v buňkách obrázku.
