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))]
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 셀에 DBNull.Value 값이 있거나 사용자가 null 셀을 편집하고 Ctrl+0을 누르면 컨트롤에 DataGridView 속성 값이 NullValue 표시됩니다. 사용자가 이 셀 스타일을 사용하여 셀을 편집하고 이 속성의 값을 입력하거나 Ctrl+0을 누르면 컨트롤은 셀 값을 속성 값 DataSourceNullValue 으로 설정하거나 null 가 이 DBNull.Value 고 셀 ValueType 이 참조 형식인 경우 DataSourceNullValue 로 설정합니다. 이 변환은 속성을 프로그래밍 방식으로 설정할 DataGridViewCell.Value 때 발생하지 않습니다.

참고

이 또는 이외의 NullValue 값으로 DataSourceNullValue 설정된 경우 DataSourceNullValue 컨트롤은 속성 값과 동일한 셀 값의 속성 값을 DBNull.Value 표시하지 null않습니다. 이 경우 이벤트를 처리 DataGridView.CellFormatting 하여 속성 값을 표시할 NullValue 수 있습니다. 자세한 내용은 이 항목의 코드 예제를 참조하세요.

이 속성은 모든 개체를 사용하므로 셀의 표시 형식에 적합한 형식의 값을 지정할 수 있습니다. 예를 들어 이 속성을 텍스트 상자 셀 또는 이미지 셀에서 사용할 이미지에 사용할 문자열 값으로 설정할 수 있습니다.

적용 대상

추가 정보