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.
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))]
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, mit dem ein NULL-Wert in einer Zelle angegeben wird. Der Standardwert ist Empty.
- Attribute
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.
