Skip to main content
.NET Framework 4.6.2+

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

PermissionSettingHelper.EnsureNavigationPermission(IPermissionPolicyRole, String) Method

Searches for the first permission for the specified navigation item in the current role. If the navigation permission is not found, it is created.

Namespace: DevExpress.ExpressApp.Security

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

#Declaration

public static IPermissionPolicyNavigationPermissionObject EnsureNavigationPermission(
    this IPermissionPolicyRole role,
    string itemPath
)

#Parameters

Name Type Description
role IPermissionPolicyRole

An IPermissionPolicyRole object specifying the security role.

itemPath String

A String value which is the path to the particular navigation item or group.

#Returns

Type Description
DevExpress.Persistent.Base.IPermissionPolicyNavigationPermissionObject

A DevExpress.Persistent.Base.IPermissionPolicyNavigationPermissionObject object specifying the found or created navigation permission.

#Remarks

You can get the correct itemPath value using the Model Editor. For this purpose, expand the NavigationItems category, find the target navigation item and copy the ItemPath property value.

ModelEditor_ItemPath

Note

If your application is created in earlier XAF versions and uses Entity Framework as the ORM system, you may need to perform a migration to use the Navigation Permissions functionality.

See Also