DataGridViewCellStyle.NullValue Propriedade

  • Referência

Definição

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

Obtém ou define o valor de exibição de célula DataGridView que corresponde a um valor de célula de Value ou 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, set
Public Property NullValue As Object

Valor da propriedade

Object

O objeto usado para indicar um valor null em uma célula. O padrão é Empty.

Atributos
TypeConverterAttribute

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

Quando uma DataGridView célula com esse estilo de célula tem um valor de DBNull.Value ou null ou o usuário edita a célula e pressiona CTRL+0, o DataGridView controle exibe o valor da NullValue propriedade. Quando um usuário edita uma célula com esse estilo de célula e insere o valor dessa propriedade ou pressiona CTRL+0, o controle define o valor da célula como o valor da DataSourceNullValue propriedade ou como null se DataSourceNullValue for DBNull.Value e a célula ValueType for 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.

Essa propriedade usa qualquer objeto , que permite que você especifique um valor com um tipo apropriado para o tipo de exibição da célula. Por exemplo, você pode definir essa propriedade como valores de cadeia de caracteres para uso por células de caixa de texto ou imagens para uso por células de imagem.

Aplica-se a

Confira também