IsGrantedExtensions.CanNavigateByRole(SecurityStrategy, IPermissionPolicyRole, String) Method

Checks whether the specified role allows navigation to the specified item.

Namespace: DevExpress.ExpressApp.Security

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

NuGet Package: DevExpress.ExpressApp.Security

Declaration

C#

public static bool CanNavigateByRole(
    this SecurityStrategy security,
    IPermissionPolicyRole targetRole,
    string itemPath
)

VB.NET

<ExtensionAttribute>
Public Shared Function CanNavigateByRole(
    security As SecurityStrategy,
    targetRole As IPermissionPolicyRole,
    itemPath As String
) As Boolean

Parameters

Name	Type	Description
security	SecurityStrategy	A SecurityStrategy object that specifies an application’s Security Strategy.
targetRole	IPermissionPolicyRole	An IPermissionPolicyRole object that is a role this method checks.
itemPath	String	A String that is a path to a navigation item.

Returns

Type	Description
Boolean	true, the specified role allows navigation to the specified item; otherwise, false.

Remarks

You can find a navigation item’s path in the Model Editor:

The following example shows how to use this method.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Security;
using DevExpress.Persistent.Base;
using DevExpress.Persistent.BaseImpl.PermissionPolicy;
// ...
public class CheckNavigatePermissionController : ObjectViewController<ListView, Contact> {
    protected override void OnActivated() {
        base.OnActivated();
        SecurityStrategy securityStrategy = Application.GetSecurityStrategy();
        foreach (IPermissionPolicyRole role in ObjectSpace.GetObjects<PermissionPolicyRole>()) {
            if (!securityStrategy.CanNavigateByRole(role, "Application/NavigationItems/Items/Default/Items/Department_ListView")) {
                // ...
            }
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Security
Imports DevExpress.Persistent.Base
Imports DevExpress.Persistent.BaseImpl.PermissionPolicy
' ...
Public Class CheckNavigatePermissionController
    Inherits ObjectViewController(Of ListView, Contact)
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        Dim securityStrategy As SecurityStrategy = Application.GetSecurityStrategy()
        For Each role As IPermissionPolicyRole In ObjectSpace.GetObjects(Of PermissionPolicyRole)()
            If Not securityStrategy.CanNavigateByRole(role, "Application/NavigationItems/Items/Default/Items/Department_ListView") Then
                ' ...
            End If
        Next role
    End Sub
End Class