DataGridViewCellStyle.NullValue Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o DataGridView valor de exibição da célula correspondente 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))>]
member this.NullValue : obj with get, setPublic Property NullValue As ObjectValor de Propriedade
O objeto usado para indicar um valor nulo numa célula. A predefinição é Empty.
- Atributos
Exemplos
O seguinte exemplo de código ilustra a utilização desta propriedade. Neste exemplo, um DataGridView.CellFormatting gestor de eventos mostra 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
Observações
Quando uma DataGridView célula com este estilo de célula tem um valor de DBNull.Value ou null , ou o utilizador edita a célula e pressiona CTRL+0, o controlo DataGridView mostra o valor da NullValue propriedade. Quando um utilizador edita uma célula com este estilo de célula e insere o valor dessa propriedade ou pressiona CTRL+0, o controlo define o valor da célula para o valor da DataSourceNullValue propriedade ou para null se DataSourceNullValue for DBNull.Value e a célula ValueType for um tipo de referência. Esta conversão não ocorre quando se define a DataGridViewCell.Value propriedade programaticamente.
Note
O controlo não mostra o NullValue valor da propriedade para valores de células igual ao DataSourceNullValue valor da propriedade quando DataSourceNullValue está definido para um valor diferente de DBNull.Value ou null. Neste caso, pode gerir o DataGridView.CellFormatting evento para mostrar o valor da NullValue propriedade. Para mais informações, veja o exemplo de código neste tópico.
Esta propriedade recebe qualquer objeto, o que permite especificar um valor com um tipo apropriado ao tipo de visualização da célula. Por exemplo, pode definir esta propriedade para valores de cadeia para uso por células de caixa de texto ou imagens para uso por células de imagem.