DataGridViewCellStyle.DataSourceNullValue Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o valor salvo para a fonte de dados quando o usuário insere um valor null em uma célula.

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, set
Public Property DataSourceNullValue As Object

Valor da propriedade

Object

O valor salvo para a fonte de dados quando o usuário especifica um valor null de célula. O padrão é Value.

Atributos
BrowsableAttribute

Exemplos

O exemplo de código a seguir ilustra o uso dessa propriedade. Neste exemplo, um DataGridView.CellFormatting manipulador de eventos exibe o valor da NullValue propriedade quando o valor da célula é 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

Comentários

O usuário pode inserir um valor nulo em uma célula pressionando CTRL+0 ou digitando o valor da NullValue propriedade. Quando o usuário confirma a alteração, o valor da célula subjacente é definido como o valor da DataSourceNullValue propriedade ou como null se DataSourceNullValue é DBNull.Value e a célula ValueType é um tipo de referência. Essa conversão não ocorre quando você define a DataGridViewCell.Value propriedade programaticamente.

Observação

O controle não exibe o valor da NullValue propriedade para valores de célula iguais ao valor da DataSourceNullValue propriedade quando DataSourceNullValue é definido como um valor diferente de DBNull.Value ou null. Nesse caso, você pode manipular o DataGridView.CellFormatting evento para exibir o valor da NullValue propriedade. Para obter mais informações, consulte o exemplo de código neste tópico.

Aplica-se a

Confira também