DataGridViewCellStyle.NullValue Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger det cellvisningsvärde DataGridView som motsvarar ett cellvärde för Value eller 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, set
Public Property NullValue As Object
Egenskapsvärde
Objektet som används för att ange ett null-värde i en cell. Standardvärdet är Empty.
- Attribut
Exempel
Följande kodexempel illustrerar användningen av den här egenskapen. I det här exemplet visar en DataGridView.CellFormatting händelsehanterare värdet för NullValue egenskapen när cellvärdet är DataSourceNullValuelika med .
// 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
Kommentarer
När en DataGridView cell med det här cellformatet har värdet DBNull.Value eller null om användaren redigerar cellen och trycker på CTRL+0 DataGridView , visar kontrollen egenskapsvärdet NullValue . När en användare redigerar en cell med det här cellformatet och anger värdet för den här egenskapen eller trycker på CTRL+0, anger kontrollen cellvärdet till värdet DataSourceNullValue för egenskapen eller till null om DataSourceNullValue är DBNull.Value och cellen ValueType är en referenstyp. Den här konverteringen DataGridViewCell.Value sker inte när du ställer in egenskapen programmatiskt.
Note
Kontrollen visar inte egenskapsvärdet NullValue för cellvärden som är lika med egenskapsvärdet DataSourceNullValue när DataSourceNullValue är inställt på ett annat värde än DBNull.Value eller null. I det här fallet kan du hantera DataGridView.CellFormatting händelsen för att visa egenskapsvärdet NullValue . Mer information finns i kodexemplet i det här avsnittet.
Den här egenskapen tar alla objekt, vilket gör att du kan ange ett värde med en typ som är lämplig för cellens visningstyp. Du kan till exempel ställa in den här egenskapen på strängvärden som ska användas av textruteceller eller bilder som ska användas av bildceller.