DataGridViewCellStyle.DataSourceNullValue Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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)>]
member this.DataSourceNullValue : obj with get, set

Public Property DataSourceNullValue As Object

Valor de propiedad

Object

El valor guardado en el origen de datos cuando el usuario especifica un valor de celda nulo. De manera predeterminada, es Value.

Atributos

BrowsableAttribute

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.

Consulte también

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Estilos de celda en el control DataGridView de formularios Windows Forms