DataGridViewCellStyle.DataSourceNullValue プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーがセルに 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)]
public object? DataSourceNullValue { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, setPublic Property DataSourceNullValue As Objectプロパティ値
ユーザーがセル値として null を指定したときにデータ ソースに保存される値。 既定値は、Value です。
- 属性
例
次のコード例は、このプロパティの使用方法を示しています。 この例では、イベント ハンドラーは 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 表示できます。 詳細については、このトピックのコード例を参照してください。
適用対象
こちらもご覧ください
.NET