DataGridViewCellStyle.NullValue Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den DataGridView-Zellenanzeigewert ab, der dem Zellenwert von Value oder null entspricht, oder legt diesen fest.

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))>]
member this.NullValue : obj with get, set

Public Property NullValue As Object

Eigenschaftswert

Object

Das Objekt, mit dem ein NULL-Wert in einer Zelle angegeben wird. Der Standardwert ist Empty.

Attribute

TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht. In diesem Beispiel zeigt ein DataGridView.CellFormatting Ereignishandler den Wert der NullValue -Eigenschaft an, wenn der Zellwert gleich ist 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

Hinweise

Wenn eine DataGridView Zelle mit diesem Zellenformat den Wert oder DBNull.Valuenull hat oder der Benutzer die Zelle bearbeitet und STRG+0 drückt, zeigt das DataGridView Steuerelement den Eigenschaftswert an NullValue . Wenn ein Benutzer eine Zelle mit diesem Zellenformat bearbeitet und den Wert dieser Eigenschaft eingibt oder STRG+0 drückt, legt das Steuerelement den Zellwert auf den Wert der DataSourceNullValue Eigenschaft oder auf null fest, wenn DataSourceNullValue ist DBNull.Value und die Zelle ValueType ein Verweistyp ist. Diese Konvertierung erfolgt nicht, wenn Sie die DataGridViewCell.Value Eigenschaft programmgesteuert festlegen.

Hinweis

Das -Steuerelement zeigt nicht den NullValue -Eigenschaftswert für Zellenwerte an, die dem DataSourceNullValue -Eigenschaftswert entsprechen, wenn DataSourceNullValue auf einen anderen Wert als DBNull.Value oder nullfestgelegt ist. In diesem Fall können Sie das DataGridView.CellFormatting -Ereignis behandeln, um den NullValue Eigenschaftswert anzuzeigen. Weitere Informationen finden Sie im Codebeispiel in diesem Thema.

Diese Eigenschaft akzeptiert ein beliebiges Objekt, mit dem Sie einen Wert mit einem Typ angeben können, der dem Anzeigetyp der Zelle entspricht. Sie können diese Eigenschaft beispielsweise auf Zeichenfolgenwerte festlegen, die von Textfeldzellen oder Bildern zur Verwendung durch Bildzellen verwendet werden.

Weitere Informationen

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Vorgehensweise: Formatieren von Daten im DataGridView-Steuerelement in Windows Forms
• Zellstile im DataGridView-Steuerelement in Windows Forms