DataGridViewCellStyle.NullValue Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el valor para DataGridView mostrar de celda correspondiente 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))]
public object? NullValue { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, setPublic Property NullValue As ObjectValor de propiedad
Objeto utilizado para indicar un valor NULL en una celda. El valor predeterminado es Empty.
- Atributos
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 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 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 valor de propiedad DataSourceNullValue cuando DataSourceNullValue se establece en un valor distinto de DBNull.Value 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.
