XafApplication.CreateDetailView(IObjectSpace, String, Boolean, Object) Method

Creates a Detail View for the specified object based on the information from the Application Model‘s Views | DetailView node specified by the detailViewID parameter.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public DetailView CreateDetailView(
    IObjectSpace objectSpace,
    string detailViewID,
    bool isRoot,
    object obj
)

VB.NET

Public Function CreateDetailView(
    objectSpace As IObjectSpace,
    detailViewID As String,
    isRoot As Boolean,
    obj As Object
) As DetailView

Parameters

Name	Type	Description
objectSpace	IObjectSpace	An IObjectSpace object which is used to work with the new Detail View’s DetailView.CurrentObject. This object is assigned to the View.ObjectSpace property.
detailViewID	String	A string that represents an identifier of the Application Model node that serves as an information source for creating a new Detail View.
isRoot	Boolean	true, if the created Detail View is independent and owns the Object Space passed using the objectSpace parameter; false, if the created Detail View is nested to another root View that owns the Object Space. This value is assigned to the View.IsRoot property.
obj	Object	An object which is represented by the new Detail View. This object is assigned to the DetailView.CurrentObject property.

Returns

Type	Description
DetailView	A Detail View that represents the object passed as the obj parameter.

Remarks

Use this method to create and initialize a Detail View according to values passed as parameters.

The detailViewID parameter should be equal the Id property of an existing IModelDetailView node from the Application Model’s Views node. If your Application Model contains several DetailView models of a certain business class, use this parameter to define which model should be used for the created View.

Pass true to the isRoot parameter if the new View owns the Object Space passed to the objectSpace parameter. If this Object Space already belongs to another View, pass false. Note that certain Controllers and Actions are deactivated in this case. See View.IsRoot for additional information. To avoid this, use the XafApplication.CreateObjectSpace or XafApplication.CreateNestedObjectSpace method to create a new Object Space, and pass this Object Space to the objectSpace parameter.

The object specified in the obj parameter should belong to the Object Space specified in the objectSpace parameter. To pass an object from another Object Space to this Object Space, use the IObjectSpace.GetObject method.

Note

Do not use another View’s View.ObjectSpace for the creation of a new root View in it. Instead, create a new Object Space using the XafApplication.CreateObjectSpace method for the new root View.

The example below demonstrates how to open an object’s Detail View via a PopupWindowShowAction.

C#

using System;
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.Persistent.Base;
using DevExpress.Persistent.BaseImpl;
// ...
public class ShowDetailViewController : ObjectViewController<ListView, Person> {
    public ShowDetailViewController() {
        PopupWindowShowAction showDetailViewAction = new PopupWindowShowAction(
            this, "ShowDetailView", PredefinedCategory.Edit);
        showDetailViewAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject;
        showDetailViewAction.CustomizePopupWindowParams += ShowDetailViewAction_CustomizePopupWindowParams;
    }
    private void ShowDetailViewAction_CustomizePopupWindowParams(
        object sender, CustomizePopupWindowParamsEventArgs e) {
        IObjectSpace objectSpace = Application.CreateObjectSpace(typeof(Person));
        Object currentObject = objectSpace.GetObject(View.CurrentObject);
        if(currentObject != null) {
            Type objectType = currentObject.GetType();
            string detailViewId = Application.GetDetailViewId(objectType);
            e.View = Application.CreateDetailView(objectSpace, detailViewId, true, currentObject);
        }
        else {
            objectSpace.Dispose();
        }
    }
}

VB.NET

Imports System
Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.Persistent.Base
Imports DevExpress.Persistent.BaseImpl

Public Class ShowDetailViewController
    Inherits ObjectViewController(Of ListView, Person)
    Public Sub New()
        Dim showDetailViewAction As New PopupWindowShowAction(Me, "ShowDetailView", PredefinedCategory.Edit)
        showDetailViewAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject
        AddHandler showDetailViewAction.CustomizePopupWindowParams, _
            AddressOf ShowDetailViewAction_CustomizePopupWindowParams
    End Sub
    Private Sub ShowDetailViewAction_CustomizePopupWindowParams(ByVal sender As Object, _
        ByVal e As CustomizePopupWindowParamsEventArgs)
        Dim objectSpace As IObjectSpace = Application.CreateObjectSpace(GetType(Person))
        Dim currentObject As Object = objectSpace.GetObject(View.CurrentObject)
        If currentObject IsNot Nothing Then
            Dim objectType As Type = currentObject.GetType()
            Dim detailViewId As String = Application.GetDetailViewId(objectType)
            e.View = Application.CreateDetailView(objectSpace, detailViewId, True, currentObject)
        Else
            objectSpace.Dispose()
        End If
    End Sub
End Class

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CreateDetailView(IObjectSpace, String, Boolean, Object) method.

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_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/CS/NonPersistentObjectsDemo.Module/Controllers/NonPersistentObjectActivatorController.cs#L41

objectSpace.RemoveFromModifiedObjects(obj);
var detailView = Application.CreateDetailView(objectSpace, shortcut.ViewId, true, obj);
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit;

VB.NET

XAF_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/VB/NonPersistentObjectsDemo.Module/Controllers/NonPersistentObjectActivatorController.vb#L43

objectSpace.RemoveFromModifiedObjects(obj)
Dim detailView = Application.CreateDetailView(objectSpace, shortcut.ViewId, True, obj)
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit