DataGridViewCellStyle.NullValue Eigenschaft

Definition

Ruft den DataGridView-Zellenanzeigewert ab, der dem Zellenwert von Value oder null entspricht, oder legt diesen fest.Gets or sets the DataGridView cell display value corresponding to a cell value of Value or 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; }
member this.NullValue : obj with get, set
Public Property NullValue As Object

Eigenschaftswert

Das Objekt, mit dem ein NULL-Wert in einer Zelle angegeben wird.The object used to indicate a null value in a cell. Die Standardeinstellung ist Empty.The default is Empty.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.The following code example illustrates the use of this property. In diesem Beispiel zeigt ein DataGridView.CellFormatting -Ereignishandler den Wert NullValue der-Eigenschaft an, DataSourceNullValuewenn der Zellwert ist.In this example, a DataGridView.CellFormatting event handler displays the value of the NullValue property when the cell value equals 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 Zellstil den Wert oder null aufweist DBNull.Value oder der Benutzer die Zelle bearbeitet und STRG + 0 drückt, zeigt das DataGridView Steuerelement den NullValue Eigenschafts Wert an.When a DataGridView cell with this cell style has a value of DBNull.Value or null or the user edits the cell and presses CTRL+0, the DataGridView control displays the NullValue property value. Wenn ein Benutzer eine Zelle mit diesem Zellstil bearbeitet und den Wert dieser Eigenschaft eingibt oder STRG + 0 drückt, legt das Steuerelement den DataSourceNullValue Zellwert auf den Wert der DBNull.Value -Eigenschaft oder auf null fest DataSourceNullValue , wenn den Wert ValueType hat und die Zelle eine ist. Verweistyp.When a user edits a cell with this cell style and enters the value of this property or presses CTRL+0, the control sets the cell value to the value of the DataSourceNullValue property or to null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. Diese Konvertierung erfolgt nicht, wenn Sie die DataGridViewCell.Value -Eigenschaft Programm gesteuert festlegen.This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

Hinweis

Das-Steuerelement zeigt nicht NullValue den-Eigenschafts Wert für Zellen Werte DataSourceNullValue an, die DataSourceNullValue dem-Eigenschafts Wert entsprechen, DBNull.Value Wenn nullauf einen anderen Wert als oder festgelegt ist.The control does not display the NullValue property value for cell values equal to the DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. In diesem Fall können Sie das DataGridView.CellFormatting -Ereignis behandeln, um den NullValue Eigenschafts Wert anzuzeigen.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Weitere Informationen finden Sie im Codebeispiel in diesem Thema.For more information, see the code example in this topic.

Diese Eigenschaft übernimmt ein beliebiges-Objekt, das es Ihnen ermöglicht, einen Wert mit einem Typ anzugeben, der für den Anzeigetyp der Zelle geeignet ist.This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. Beispielsweise können Sie diese Eigenschaft auf Zeichen folgen Werte festlegen, die von Textfeld-Zellen oder Bildern für die Verwendung durch Bild Zellen verwendet werden sollen.For example, you can set this property to string values for use by text box cells or images for use by image cells.

Gilt für:

Siehe auch