DataGridViewCellStyle.DataSourceNullValue 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 guardado en el origen de datos cuando el usuario escribe un valor nulo en una celda.
public:
property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }[System.ComponentModel.Browsable(false)]
public object? DataSourceNullValue { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, setPublic Property DataSourceNullValue As ObjectValor de propiedad
El valor guardado en el origen de datos cuando el usuario especifica un valor de celda nulo. De manera predeterminada, es Value.
- 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 DataSourceNullValueigual a .
// 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
El usuario puede escribir un valor NULL en una celda presionando CTRL+0 o escribiendo el valor de la NullValue propiedad. Cuando el usuario confirma el cambio, el valor de celda subyacente se establece 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 iguales al valor de DataSourceNullValue 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.
