DataGridViewCellStyle.DataSourceNullValue 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 valor guardado na fonte de dados quando o utilizador insere um valor nulo numa 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)>]
member this.DataSourceNullValue : obj with get, setPublic Property DataSourceNullValue As ObjectValor de Propriedade
O valor guardado na fonte de dados quando o utilizador especifica um valor de célula nula. A predefinição é Value.
- 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
O utilizador pode introduzir um valor nulo numa célula pressionando CTRL+0 ou escrevendo o valor da NullValue propriedade. Quando o utilizador faz o commit da alteração, o valor subjacente da célula é definido 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.