XafApplication.LinkNewObjectToParentImmediately Property

Specifies whether or not a link between a master and child object is created immediately when the NewObjectViewController.NewObjectAction is executed in a nested List View with a non-aggregated collection.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[Browsable(false)]
[DefaultValue(true)]
public bool LinkNewObjectToParentImmediately { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(True)>
Public Property LinkNewObjectToParentImmediately As Boolean

Property Value

Type	Default	Description
Boolean	true	true if the link between a master and child object is created when the child object is committed; false if the link is created when the parent is committed.

Remarks

Since v20.2, the default LinkNewObjectToParentImmediately property value is false because the Solution Wizard generates new projects with the FrameworkSettings.DefaultSettingsCompatibilityMode property set to Latest.

The table below shows how the New Action behavior changes in a nested List View with a non-aggregated collection depending on the LinkNewObjectToParentImmediately value.

Value	Description
true	The new object linked to the master object is created and the master object is committed when the New Action is executed. The reference to the master object is available in the new child object immediately after creation.
false	The master object is not committed and the link is not created when the New Action is executed. The reference to the master object is not added to the new child object immediately. The link is created later when the child object is committed. To persist the link, a user should also save the master object. Otherwise, the unlinked child object is saved.

To change the behavior for an entire application, set the LinkNewObjectToParentImmediately property in your application project‘s XafApplication (WinApplication, WebApplication, or BlazorApplication) descendent class constructor.

C#

namespace MySolution.Win {
    public partial class MySolutionWindowsFormsApplication : WinApplication {
        public MySolutionWindowsFormsApplication() {
            // ...
            LinkNewObjectToParentImmediately = true;
        }
        // ...
    }
}

VB.NET

Namespace MySolution.Win
    Partial Public Class MySolutionWindowsFormsApplication
        Inherits WinApplication
        Public Sub New()
            ' ...
            LinkNewObjectToParentImmediately = True
        End Sub
        ' ...
    End Class
End Namespace

To change the behavior for a specific View, set the NewObjectViewController.LinkNewObjectToParentImmediately property in a Controller that targets the required View. The behavior of aggregated collections is not changed.

In many-to-many collections, the New Action is hidden when LinkNewObjectToParentImmediately is set to true.

Tip

This property is hidden in the Application Designer. You can use it in code only.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the LinkNewObjectToParentImmediately property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

xaf-how-to-customize-an-aspnet-template/CS/CustomizeTemplate.Web/WebApplication.cs#L67

this.ApplicationName = "CustomizeTemplate";
this.LinkNewObjectToParentImmediately = false;
this.CheckCompatibilityType = DevExpress.ExpressApp.CheckCompatibilityType.DatabaseSchema;

VB.NET

xaf-how-to-customize-an-aspnet-template/VB/CustomizeTemplate.Web/WebApplication.vb#L57

Me.ApplicationName = "CustomizeTemplate"
Me.LinkNewObjectToParentImmediately = False
Me.CheckCompatibilityType = DevExpress.ExpressApp.CheckCompatibilityType.DatabaseSchema