DataGridViewCell.DefaultNewRowValue Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewCell.cs

Ruft den Standardwert für eine Zelle in der Zeile für neue Datensätze ab.

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

Eigenschaftswert

Object

Ein Object, das den Standardwert darstellt.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DefaultNewRowValue -Eigenschaft in einer CalendarCell Klasse überschrieben wird, die von abgeleitet wird DataGridViewTextBoxCell. Dieses Beispiel ist Teil eines umfangreicheren Codebeispiels unter Vorgehensweise: Hosten von Steuerelementen 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;
        }
    }
}

Hinweise

Die DefaultNewRowValue -Eigenschaft in der Basisklasse DataGridViewCell gibt immer zurück null. Diese Eigenschaft kann jedoch in abgeleiteten Zellklassen überschrieben werden, um andere Standardwerte zurückzugeben.

Der von dieser Eigenschaft zurückgegebene Wert wird angezeigt, wenn sich die Zelle in der Zeile für neue Datensätze befindet. Dieser Wert kann von einem Handler für das Ereignis überschrieben werden, wenn der DataGridView.DefaultValuesNeeded Fokus die Zeile für neue Datensätze eingibt.

Gilt für:

Weitere Informationen

• DataGridView
• Value
• FormattedValue