DataGridViewCellStyle.NullValue プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

DataGridViewCellStyle.cs

Valueまたはnullのセル値に対応するDataGridView セルの表示値を取得または設定します。

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))>]
member this.NullValue : obj with get, set

Public Property NullValue As Object

プロパティ値

Object

セル内の null 値を示すために使用されるオブジェクト。 既定値は、Empty です。

属性

TypeConverterAttribute

例

次のコード例は、このプロパティの使用方法を示しています。 この例では、DataGridView.CellFormatting イベント ハンドラーは、セル値がDataSourceNullValue等しい場合に、NullValue プロパティの値を表示します。

// 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 の場合、またはユーザーがセルを編集して Ctrl + 0 キーを押すと、 DataGridView コントロールに NullValue プロパティ値が表示されます。 ユーザーがこのセル スタイルでセルを編集し、このプロパティの値を入力するか、Ctrl キーを押しながら 0 キーを押すと、コントロールはセル値を DataSourceNullValue プロパティの値に設定するか、DataSourceNullValueがDBNull.ValueでセルValueTypeが参照型の場合はnullに設定します。 DataGridViewCell.Value プロパティをプログラムで設定した場合、この変換は行われません。

注

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

このプロパティは任意のオブジェクトを受け取ります。これにより、セルの表示型に適した型を持つ値を指定できます。 たとえば、テキスト ボックスのセルで使用する文字列値、または画像セルで使用する画像にこのプロパティを設定できます。

こちらもご覧ください

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• 方法: Windows フォーム DataGridView コントロールでデータを書式設定する
• Windows フォーム DataGridView コントロールのセル スタイル