DataGridViewCellStyle.NullValue 속성

정의

DataGridView 또는 null의 셀 값에 해당하는 Value 셀 표시 값을 가져오거나 설정합니다.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; }
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, set
Public Property NullValue As Object

속성 값

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 이벤트 처리기는 NullValue 셀 값이 이면 속성의 값을 표시 합니다 DataSourceNullValue .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 null DataSourceNullValue 가이 DBNull.Value 고 셀 ValueType 이 참조 형식인 경우로 설정 합니다.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.

참고

NullValue DataSourceNullValue DataSourceNullValue 이 또는 이외의 값으로 설정 된 경우 컨트롤에는 속성 값과 같은 셀 값에 대 한 속성 값이 표시 되지 않습니다 DBNull.Value null .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.

적용 대상

추가 정보