DataGridViewCellStyle.DataSourceNullValue プロパティ


ユーザーがセルに 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. この例では、セル値が DataSourceNullValueに等しい場合、DataGridView.CellFormatting イベントハンドラーによって 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 プロパティの値に設定されるか、DataSourceNullValueDBNull.Value、セルの ValueType が参照型である場合は 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.


DataSourceNullValueDBNull.Value または null以外の値に設定されている場合、コントロールは、DataSourceNullValue プロパティ値と等しいセル値の NullValue プロパティ値を表示しません。The 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.