DataGridViewCellStyle.DataSourceNullValue DataGridViewCellStyle.DataSourceNullValue DataGridViewCellStyle.DataSourceNullValue DataGridViewCellStyle.DataSourceNullValue Property

Definition

Ruft den in der Datenquelle gespeicherten Wert ab, wenn der Benutzer einen NULL-Wert in eine Zelle eingibt, oder legt diesen fest.Gets or sets the value saved to the data source when the user enters a null value into a cell.

public:
 property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }
member this.DataSourceNullValue : obj with get, set
Public Property DataSourceNullValue As Object

Eigenschaftswert

Der in der Datenquelle gespeicherte Wert, wenn der Benutzer einen NULL Zellenwert angibt.The value saved to the data source when the user specifies a null cell value. Die Standardeinstellung ist Value.The default is Value.

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

Der Benutzer kann einen NULL-Wert in eine Zelle eingeben, indem er STRG + 0 drückt oder den Wert NullValue der-Eigenschaft eingegeben hat.The user can enter a null value into a cell by pressing CTRL+0 or by typing the value of the NullValue property. Wenn der Benutzer einen Commit für die Änderung ausführt, wird der zugrunde liegende Zellwert auf den DataSourceNullValue Wert der DBNull.Value - null Eigenschaft DataSourceNullValue oder auf festgelegt ValueType , wenn den Wert hat und die Zelle ein Verweistyp ist.When the user commits the change, the underlying cell value is set 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.

Gilt für:

Siehe auch