DataGridViewCell.DefaultNewRowValue Propriedade

public:
 virtual property System::Object ^ DefaultNewRowValue { System::Object ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual object DefaultNewRowValue { get; }

[System.ComponentModel.Browsable(false)]
public virtual object? DefaultNewRowValue { get; }

[<System.ComponentModel.Browsable(false)>]
member this.DefaultNewRowValue : obj

Public Overridable ReadOnly Property DefaultNewRowValue As Object

Valor da propriedade

Um Object valor que representa o valor padrão.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra como substituir a DefaultNewRowValue propriedade em uma CalendarCell classe que deriva de DataGridViewTextBoxCell. Este exemplo faz parte de um exemplo de código maior fornecido em How to: Host Controls in Windows Forms DataGridView Cells.

public class CalendarCell : DataGridViewTextBoxCell
{

    public CalendarCell()
        : base()
    {
        // Use the short date format.
        this.Style.Format = "d";
    }

    public override void InitializeEditingControl(int rowIndex, object 
        initialFormattedValue, DataGridViewCellStyle dataGridViewCellStyle)
    {
        // Set the value of the editing control to the current cell value.
        base.InitializeEditingControl(rowIndex, initialFormattedValue, 
            dataGridViewCellStyle);
        CalendarEditingControl ctl = 
            DataGridView.EditingControl as CalendarEditingControl;
        // Use the default row value when Value property is null.
        if (this.Value == null)
        {
            ctl.Value = (DateTime)this.DefaultNewRowValue;
        }
        else
        {
            ctl.Value = (DateTime)this.Value;
        }
    }

    public override Type EditType
    {
        get
        {
            // Return the type of the editing control that CalendarCell uses.
            return typeof(CalendarEditingControl);
        }
    }

    public override Type ValueType
    {
        get
        {
            // Return the type of the value that CalendarCell contains.
            
            return typeof(DateTime);
        }
    }

    public override object DefaultNewRowValue
    {
        get
        {
            // Use the current date and time as the default value.
            return DateTime.Now;
        }
    }
}

Public Class CalendarCell
    Inherits DataGridViewTextBoxCell

    Public Sub New()
        ' Use the short date format.
        Me.Style.Format = "d"
    End Sub

    Public Overrides Sub InitializeEditingControl(ByVal rowIndex As Integer, _
        ByVal initialFormattedValue As Object, _
        ByVal dataGridViewCellStyle As DataGridViewCellStyle)

        ' Set the value of the editing control to the current cell value.
        MyBase.InitializeEditingControl(rowIndex, initialFormattedValue, _
            dataGridViewCellStyle)

        Dim ctl As CalendarEditingControl = _
            CType(DataGridView.EditingControl, CalendarEditingControl)

        ' Use the default row value when Value property is null.
        If (Me.Value Is Nothing) Then
            ctl.Value = CType(Me.DefaultNewRowValue, DateTime)
        Else
            ctl.Value = CType(Me.Value, DateTime)
        End If
    End Sub

    Public Overrides ReadOnly Property EditType() As Type
        Get
            ' Return the type of the editing control that CalendarCell uses.
            Return GetType(CalendarEditingControl)
        End Get
    End Property

    Public Overrides ReadOnly Property ValueType() As Type
        Get
            ' Return the type of the value that CalendarCell contains.
            Return GetType(DateTime)
        End Get
    End Property

    Public Overrides ReadOnly Property DefaultNewRowValue() As Object
        Get
            ' Use the current date and time as the default value.
            Return DateTime.Now
        End Get
    End Property

End Class

Comentários

A DefaultNewRowValue propriedade na classe DataGridViewCell base sempre retorna null. No entanto, essa propriedade pode ser substituída em classes de células derivadas para retornar outros valores padrão.

O valor retornado por essa propriedade será exibido se a célula estiver na linha para novos registros. Esse valor pode ser substituído por um manipulador para o evento quando o DataGridView.DefaultValuesNeeded foco entra na linha para novos registros.

Confira também

• DataGridView
• Value
• FormattedValue