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


ユーザーがセルに null 値を入力したときにデータ ソースに保存される値を取得または設定します。Gets or sets the value saved to the data source when the user enters a null value into a cell.

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


ユーザーがセル値として null を指定したときにデータ ソースに保存される値。The value saved to the data source when the user specifies a null cell value. 既定値は、Value です。The default is Value.

次のコード例は、このプロパティの使用方法を示しています。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


ユーザーは、CTRL キーを押しながら0キーを押すか、 NullValueプロパティの値を入力して、セルに null 値を入力できます。The user can enter a null value into a cell by pressing CTRL+0 or by typing the value of the NullValue property. ユーザーが変更をコミットすると、基になるセルの値がDataSourceNullValueプロパティの値に設定されるか、がDBNull.ValueValueType 、セルが参照型である場合DataSourceNullValueはにnull設定されます。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. プログラムによってプロパティを設定した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.