XafApplication.CreateDetailView(IObjectSpace, Object, View) Method

Creates a Detail View for a specified object based on information on the source View.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public DetailView CreateDetailView(
    IObjectSpace objectSpace,
    object obj,
    View sourceView
)

VB.NET

Public Function CreateDetailView(
    objectSpace As IObjectSpace,
    obj As Object,
    sourceView As View
) As DetailView

Parameters

Name	Type	Description
objectSpace	IObjectSpace	An IObjectSpace object representing the Object Space which is used to work with the new Detail View DetailView.CurrentObject. This object is assigned to the View.ObjectSpace property.
obj	Object	An object which is represented by the new Detail View. This object is assigned to the DetailView.CurrentObject property.
sourceView	View	A View object that represents the View in which the command to show the new Detail View has been performed.

Returns

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

Remarks

If the new Detail View‘s View.ObjectSpace is different from the source View’s Object Space, its View.IsRoot property is set to true. Note that certain Controllers and Actions are deactivated if the IsRoot property is set to false. To avoid this, use the XafApplication.CreateObjectSpace or XafApplication.CreateNestedObjectSpace method to create a new Object Space, and pass this Object Space as 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.

Use this overload when you need information on the source View to determine what Detail View to create. Pass the source View as the sourceView parameter. If the source View is a DetailView, the method uses information from the Application Model‘s Views | <View> node to create a new Detail View. If the source View is a List View, the method retrieves the Application Model’s node information from the List View’s ListView.DetailViewId property.

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) {
            e.View = Application.CreateDetailView(objectSpace, currentObject, View);
        }
        else {
            objectSpace.Dispose();
        }
    }
}

VB.NET

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
            e.View = Application.CreateDetailView(objectSpace, currentObject, View)
        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, Object, View) 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-win-web-open-detail-view-when-grid-row-is-clicked-in-the-dashboard/CS/ShowDetailViewFromDashboard.Module.Web/Controllers/WebShowDetailViewFromDashboardController.cs#L59

if (contact != null) {
    e.ShowViewParameters.CreatedView = Application.CreateDetailView(objectSpace, contact, View);
}

VB.NET

xaf-win-web-open-detail-view-when-grid-row-is-clicked-in-the-dashboard/VB/ShowDetailViewFromDashboard.Module.Win/Controllers/WinShowDetailViewFromDashboardController.vb#L60

If contact IsNot Nothing Then
    e.ShowViewParameters.CreatedView = Application.CreateDetailView(objectSpace, contact, View)
End If