Xceed DataGrid for WPF v7.3 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid Namespace / DataGridCreatingNewItemEventArgs Class / NewItem Property


In This Topic
    NewItem Property
    In This Topic
    Gets or sets the new item to add to the CollectionView.
    Syntax
    'Declaration
     
    Public Property NewItem As Object
    'Usage
     
    Dim instance As DataGridCreatingNewItemEventArgs
    Dim value As Object
     
    instance.NewItem = value
     
    value = instance.NewItem
    public object NewItem {get; set;}

    Property Value

    The new item to add to the CollectionView. Will be a null reference (Nothing in Visual Basic) by default  (see Remarks).
    Remarks

    If the insertion of new items is to be handled manually, a new item must be provided and the Handled property set to true to indicate that the process will be handled manually. If a new item is provided but the Handled property was not set or was set to false, the item will be ignored and a new item will be created by the DataGridCollectionView (if possible). An InvalidOperationException will be thrown if the Handled property is set to true but a new item is not provided.

    If a new item is not provided and the event is not handled, an attempt will be made by the DataGridCollectionView to create a new item.

    Requirements

    Target Platforms: Windows 11, Windows, 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also