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

NuGet Package: DevExpress.ExpressApp.Security

Declaration

C#

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

VB.NET

<ExtensionAttribute>
Public Shared Function EnsureNavigationPermission(
    role As IPermissionPolicyRole,
    itemPath As String
) As IPermissionPolicyNavigationPermissionObject

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.

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.