DataGridViewCellStyle.NullValue DataGridViewCellStyle.NullValue DataGridViewCellStyle.NullValue DataGridViewCellStyle.NullValue Property

Определение

Получает или задает отображаемое значение ячейки 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 обработчик событий отображает значение 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

Комментарии

NullValue DataGridView null DBNull.Value Если ячейка с этим стилем ячейки имеет значение или или пользователь редактирует ячейку и нажимает клавиши CTRL + 0, элемент управления отображает значение свойства. DataGridViewWhen 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 DataSourceNullValue + 0, элемент управления устанавливает для ячейки значение свойства 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.

Применяется к

Дополнительно