DataGridViewCellStyle.NullValue Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el valor de presentación de la celda DataGridView que corresponde a un valor de celda de Value o 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

Valor de propiedad

Object

Objeto utilizado para indicar un valor nulo en una celda. De manera predeterminada, es Empty.

Atributos

TypeConverterAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de esta propiedad. En este ejemplo, un DataGridView.CellFormatting controlador de eventos muestra el valor de la NullValue propiedad cuando el valor de la celda es igual a 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

Comentarios

Cuando una DataGridView celda con este estilo de celda tiene un valor de DBNull.Value o null o el usuario edita la celda y presiona CTRL+0, el DataGridView control muestra el valor de la NullValue propiedad. Cuando un usuario edita una celda con este estilo de celda y escribe el valor de esta propiedad o presiona CTRL+0, el control establece el valor de celda en el valor de la DataSourceNullValue propiedad o en null si DataSourceNullValue es DBNull.Value y la celda ValueType es un tipo de referencia. Esta conversión no se produce cuando se establece la DataGridViewCell.Value propiedad mediante programación.

Nota

El control no muestra el NullValue valor de propiedad de los valores de celda igual al DataSourceNullValue valor de propiedad cuando DataSourceNullValue se establece en un valor distinto DBNull.Value de o null. En este caso, puede controlar el DataGridView.CellFormatting evento para mostrar el valor de la NullValue propiedad. Para obtener más información, vea el ejemplo de código de este tema.

Esta propiedad toma cualquier objeto , que permite especificar un valor con un tipo adecuado para el tipo de presentación de la celda. Por ejemplo, puede establecer esta propiedad en valores de cadena para su uso por celdas de cuadro de texto o imágenes para su uso por celdas de imagen.

Consulte también

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Dar formato a datos en el control DataGridView de Windows Forms
• Estilos de celda en el control DataGridView de formularios Windows Forms