WebApplication.Settings Property

Specifies settings of the ASP.NET Web Forms application’s Templates content.

Namespace: DevExpress.ExpressApp.Web

Assembly: DevExpress.ExpressApp.Web.v24.2.dll

NuGet Package: DevExpress.ExpressApp.Web

Declaration

C#

[Browsable(false)]
public TemplateContentSettings Settings { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property Settings As TemplateContentSettings

Property Value

Type	Description
TemplateContentSettings	A TemplateContentSettings object that specifies settings of the ASP.NET Web Forms application’s templates content.

Remarks

Built-in Templates are located in an XAF application’s ASP.NET Web Forms application project. The default template content is carried out to User Controls located in the DevExpress.ExpressApp.Web assembly, so the content is updated automatically when you upgrade to the new version of XAF. You can add XAF page content to the application project and make required modifications with it (see How to: Customize an ASP.NET Web Forms Template). To use the modified content instead of the default, open the Global.asax.cs (Global.asax.vb) file and specify the path to your custom User Control as shown below.

C#

protected void Session_Start(Object sender, EventArgs e) {
    // ...
    WebApplication.Instance.Settings.DefaultVerticalTemplateContentPath =
        "MyDefaultVerticalTemplateContent.ascx";
    WebApplication.Instance.Setup();
    WebApplication.Instance.Start();
}

VB.NET

Protected Sub Session_Start(ByVal sender As Object, ByVal e As EventArgs)
    ' ...
    WebApplication.Instance.Settings.DefaultVerticalTemplateContentPath = _
        "MyDefaultVerticalTemplateContent.ascx"
    WebApplication.Instance.Setup()
    WebApplication.Instance.Start()
End Sub

In this code, a path to the DefaultVertical template content is changed. More settings that specify paths to the content of other templates are available via the TemplateContentSettings object assigned to the Settings property. To simplify the creation of User Controls, XAF provides the project item templates. The table below lists the TemplateContentSettings object’s properties and their corresponding project item templates.

Property	Project Item Template
TemplateContentSettings.DefaultVerticalTemplateContentPath	Deprecated Templates | Default Vertical Template Content XAF ASP.NET Web Forms Templates | Default Vertical Template Content
TemplateContentSettings.DefaultTemplateContentPath	Deprecated Templates | Default Template Content
TemplateContentSettings.DialogTemplateContentPath	Deprecated Templates | Dialog Template Content XAF ASP.NET Web Forms Templates | Dialog Template Content
TemplateContentSettings.FindDialogTemplateContentPath	XAF ASP.NET Web Forms Templates | Find Dialog Template Content
TemplateContentSettings.LogonTemplateContentPath	Deprecated Templates | Logon Template Content XAF ASP.NET Web Forms Templates | Logon Template Content
TemplateContentSettings.NestedFrameControlPath	Deprecated Templates | Nested Frame Control XAF ASP.NET Web Forms Templates | Nested Frame Control