DataGridViewCellStyle.NullValue 속성

정의

DataGridView 또는 Value의 셀 값에 해당하는 null 셀 표시 값을 가져오거나 설정합니다.Gets or sets the DataGridView cell display value corresponding to a cell value of Value or null.

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; }
member this.NullValue : obj with get, set
Public Property NullValue As Object

속성 값

셀의 null 값을 나타내는 데 사용되는 개체입니다.The object used to indicate a null value in a cell. 기본값은 Empty입니다.The default is Empty.

특성

예제

다음 코드 예제에서는이 속성의 사용을 보여 줍니다.The following code example illustrates the use of this property. 이 예제에서 DataGridView.CellFormatting 이벤트 처리기는 셀 값이 DataSourceNullValueNullValue 속성의 값을 표시 합니다.In this example, a DataGridView.CellFormatting event handler displays the value of the NullValue property when the cell value equals 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 속성 값을 표시 합니다.When a DataGridView cell with this cell style has a value of DBNull.Value or null or the user edits the cell and presses CTRL+0, the DataGridView control displays the NullValue property value. 사용자가이 셀 스타일을 사용 하 여 셀을 편집 하 고이 속성의 값을 입력 하거나 CTRL + 0을 누르면 컨트롤은 셀 값을 DataSourceNullValue 속성 값으로 설정 하 고 DataSourceNullValue DBNull.Value이 고 셀 ValueType이 참조 형식이 면 null 합니다.When a user edits a cell with this cell style and enters the value of this property or presses CTRL+0, the control sets the cell value to the value of the DataSourceNullValue property or to null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. DataGridViewCell.Value 속성을 프로그래밍 방식으로 설정 하는 경우에는이 변환이 수행 되지 않습니다.This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

참고

DataSourceNullValueDBNull.Value 또는 null이외의 값으로 설정 된 경우 컨트롤은 DataSourceNullValue 속성 값과 같은 셀 값에 대 한 NullValue 속성 값을 표시 하지 않습니다.The control does not display the NullValue property value for cell values equal to the DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. 이 경우 DataGridView.CellFormatting 이벤트를 처리 하 여 NullValue 속성 값을 표시할 수 있습니다.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. 자세한 내용은이 항목의 코드 예제를 참조 하세요.For more information, see the code example in this topic.

이 속성은 셀의 표시 형식에 적합 한 형식으로 값을 지정할 수 있는 모든 개체를 사용 합니다.This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. 예를 들어 수이 속성을 설정한이 사용에 대 한 문자열 값에 사용할 이미지 또는 텍스트 상자 셀 이미지 셀에서.For example, you can set this property to string values for use by text box cells or images for use by image cells.

적용 대상

추가 정보