DataGridViewCellStyle.DataSourceNullValue プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ユーザーがセルに null 値を入力したときにデータ ソースに保存される値を取得または設定します。

public:
 property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, set

Public Property DataSourceNullValue As Object

プロパティ値

Object

ユーザーがセル値として null を指定したときにデータ ソースに保存される値。 既定値は、Value です。

属性

BrowsableAttribute

例

次のコード例は、このプロパティの使用方法を示しています。 この例では、イベント ハンドラーは DataGridView.CellFormatting 、セルの値が と等しい場合に NullValue 、 プロパティの値を表示します 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 キーを押すか、 プロパティの値を入力して、セルに null 値を NullValue 入力できます。 ユーザーが変更をコミットすると、基になるセルの値が プロパティのDataSourceNullValue値に設定されます。または、 が DBNull.Value でセルValueTypeが参照型の場合DataSourceNullValueは にnull設定されます。 この変換は、 プロパティをプログラムで DataGridViewCell.Value 設定しても発生しません。

注意

が または null以外DBNull.Valueの値にNullValue設定されている場合DataSourceNullValue、コントロールは、プロパティ値とDataSourceNullValue等しいセル値のプロパティ値を表示しません。 この場合は、 イベントを DataGridView.CellFormatting 処理してプロパティ値を NullValue 表示できます。 詳細については、このトピックのコード例を参照してください。

こちらもご覧ください

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Windows フォーム DataGridView コントロールでのセルのスタイル