DataGridViewCellStyle.NullValue プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

セル値が DataGridView または null である場合に Value のセルに表示する値を取得または設定します。

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 、セルの値が と等しい場合に 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

注釈

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

注意

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

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

こちらもご覧ください

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