DataGridViewCellStyle.NullValue プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridViewCellStyle.NullValue プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

セル値が DBNull.Value または null 参照 (Visual Basic では Nothing) である場合に DataGridView のセルに表示する値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property NullValue As
 Object

Visual Basic (使用法)

Dim instance As DataGridViewCellStyle
Dim value As Object

value = instance.NullValue

instance.NullValue = value

C#

public Object NullValue { get; set;
 }

C++

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

J#

/** @property */
public Object get_NullValue ()

/** @property */
public void set_NullValue (Object value)

JScript

public function get NullValue
 () : Object

public function set NullValue
 (value : Object)

プロパティ値
セル値が null であることを示すために使用するオブジェクト。既定値は String.Empty です。

解説

このセル スタイルが適用されている DataGridView セルの値が DBNull.Value または null 参照 (Visual Basic では Nothing) の場合、またはユーザーがこのセルを編集して Ctrl キーを押しながら 0 キーを押した場合、DataGridView コントロールには、NullValue プロパティ値が表示されます。ユーザーがこのセル スタイルが適用されているセルを編集して、このプロパティの値を入力するか、または Ctrl キーを押しながら 0 キーを押すと、コントロールはセル値を DataSourceNullValue プロパティの値に設定します。ただし、DataSourceNullValue が DBNull.Value で、セルの ValueType が参照型である場合は、null 参照 (Visual Basic では Nothing) に設定されます。プログラムによって DataGridViewCell.Value プロパティを設定した場合、この変換は行われません。

メモ
DataSourceNullValue が DBNull.Value や null 参照 (Visual Basic では Nothing) 以外の値に設定されている場合、このコントロールには、DataSourceNullValue プロパティ値に等しいセル値の NullValue プロパティ値が表示されません。この場合、DataGridView.CellFormatting イベントを処理して NullValue プロパティ値を表示できます。

このプロパティには任意のオブジェクトを設定できるため、セルの表示型に適応する型の値を指定できます。たとえば、このプロパティではテキスト ボックス セルには文字列値を設定し、イメージ セルにはイメージを設定します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCellStyle クラス
DataGridViewCellStyle メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.CellFormatting イベント
DataGridViewCell.Value プロパティ
DataSourceNullValue
IsDataSourceNullValueDefault
その他の技術情報
方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する
Windows フォーム DataGridView コントロールでのセルのスタイル