DataGridViewCellStyle.NullValue プロパティ


セル値が DataGridView または null である場合に Value のセルに表示する値を取得または設定します。Gets or sets the DataGridView cell display value corresponding to a cell value of Value or null.

 property System::Object ^ NullValue { System::Object ^ get(); void set(System::Object ^ value); };
public object NullValue { get; set; }
member this.NullValue : obj with get, set
Public Property NullValue As Object


セル値が null であることを示すために使用するオブジェクト。The object used to indicate a null value in a cell. 既定値は、Empty です。The default is Empty.


次のコード例は、このプロパティの使用方法を示しています。The following code example illustrates the use of this property. この例では、 DataGridView.CellFormattingセルの値がと等しいDataSourceNullValue場合NullValue 、イベントハンドラーによってプロパティの値が表示されます。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


DataGridView DBNull.Value nullこのセルスタイルを持つNullValueセルの値がまたはであるか、ユーザーがセルを編集して CTRL + 0 キーを押すと、コントロールにプロパティ値が表示されます。 DataGridViewWhen 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. ユーザーがこのセルスタイルを使用してセルを編集し、このプロパティの値を入力するか、CTRL + 0 キーを押すと、コントロールはセルDataSourceNullValueの値をプロパティのDBNull.Value値に設定します。がで、セルValueTypeがである場合DataSourceNullValueはにnull設定します。参照型。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. プログラムによってプロパティを設定したDataGridViewCell.Value場合、この変換は発生しません。This conversion does not occur when you set the DataGridViewCell.Value property programmatically.


NullValueまたは以外null DataSourceNullValue DataSourceNullValue の値に設定されている場合、コントロールは、プロパティ値に等しいセル値のプロパティ値を表示しません。DBNull.ValueThe 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. この場合は、 DataGridView.CellFormattingイベントを処理してNullValueプロパティ値を表示できます。In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. 詳細については、このトピックのコード例を参照してください。For more information, see the code example in this topic.

このプロパティは、任意のオブジェクトを受け取ります。これにより、セルの表示の種類に適した型の値を指定できます。This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. たとえば、このプロパティを文字列値に設定すると、テキストボックスのセルや画像のセルで使用するイメージで使用できます。For example, you can set this property to string values for use by text box cells or images for use by image cells.