DataGridViewCellStyle.DataSourceNullValue Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den in der Datenquelle gespeicherten Wert ab, wenn der Benutzer einen NULL-Wert in eine Zelle eingibt, oder legt diesen fest.

public:
 property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }

[System.ComponentModel.Browsable(false)]
public object? DataSourceNullValue { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, set

Public Property DataSourceNullValue As Object

Eigenschaftswert

Object

Der in der Datenquelle gespeicherte Wert, wenn der Benutzer einen NULL Zellenwert angibt. Der Standardwert ist Value.

Attribute: BrowsableAttribute

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

Der Benutzer kann einen NULL-Wert in eine Zelle eingeben, indem er STRG+0 drückt oder den Wert der NullValue -Eigenschaft eingibt. Wenn der Benutzer die Änderung committet, wird der zugrunde liegende Zellwert auf den Wert der DataSourceNullValue Eigenschaft oder auf null festgelegt, wenn DataSourceNullValue dies 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.

Gilt für:

Teilen über