DataGridViewCellStyle.NullValue Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen des Zellenanzeigewerts, der DataGridView einem Zellwert von Value oder 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, setPublic Property NullValue As ObjectEigenschaftswert
Das Objekt, das verwendet wird, um einen Nullwert in einer Zelle anzugeben. Der Standardwert lautet Empty.
- Attribute
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung dieser Eigenschaft. 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 dieser Zellenformatvorlage einen Wert aufweist DBNull.Value oder null der Benutzer die Zelle bearbeitet und STRG+0 drückt, zeigt das DataGridView Steuerelement den NullValue Eigenschaftswert an. Wenn ein Benutzer eine Zelle mit dieser Zellenformatvorlage bearbeitet und den Wert dieser Eigenschaft eingibt oder STRG+0 drückt, legt das Steuerelement den Zellwert auf den Wert der DataSourceNullValue Eigenschaft oder null auf den Fall DBNull.ValueDataSourceNullValue fest, und die Zelle ValueType ist ein Bezugstyp. Diese Konvertierung tritt nicht auf, wenn Sie die DataGridViewCell.Value Eigenschaft programmgesteuert festlegen.
Hinweis
Das Steuerelement zeigt nicht den NullValue Eigenschaftswert für Zellwerte an, die dem DataSourceNullValue Eigenschaftswert entsprechen, wenn DataSourceNullValue er 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 verwendet 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 für die Verwendung durch Bildzellen verwendet werden.
