XafApplication.Security Property

Provides access to the Security Strategy used in the application.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v23.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[Browsable(false)]
public ISecurityStrategyBase Security { get; set; }

VB.NET

<Browsable(False)>
Public Property Security As ISecurityStrategyBase

Property Value

Type	Description
ISecurityStrategyBase	An object that is the ISecurityStrategyBase Security Strategy.

Remarks

If you need to configure a Security System via built-in classes, use the Application Designer. To create a custom Security Strategy or Authentication Type, set the Security property in code:

C#

static class Program {
   // ... 
   public static void Main() {
      // ... 
      MySolutionWindowsFormsApplication application = new MySolutionWindowsFormsApplication();
      application.Security = new MySecurityStrategy<User, Role>(new MyAuthenticationStrategy<User, 
         AuthenticationStandardLogonParameters>())
      // ... 
      application.Setup();
      application.Start();
      // ... 
   }
}

VB.NET

Friend Class Program
   ' ... 
   Public Shared Sub Main()
      ' ... 
      Dim _application As MySolutionWindowsFormsApplication = _
      New MySolutionWindowsFormsApplication()
      _application.Security = New MySecurityStrategy(Of User, Role)( _
      New MyAuthenticationStrategy(Of User, AuthenticationStandardLogonParameters)())
      ' ... 
      _application.Setup()
      _application.Start()
      ' ... 
   End Sub 
End Class

For details on the Security System supplied by XAF, refer to the Security System Overview topic.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Security property.

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_how-to-allow-a-user-to-select-the-authentication-type-at-runtime-e2371/CS/E2371.Module/SetupAuthenticationHelper.cs#L18

CustomAuthenticationStandardProvider authenticationStandardProvider = new CustomAuthenticationStandardProvider(application.Security.UserType);
AuthenticationActiveDirectoryProvider authenticationActiveDirectoryProvider = new AuthenticationActiveDirectoryProvider(application.Security.UserType, (ICanInitializeNewUser)application.Security, true);
authenticationActiveDirectoryProvider.CustomCreateUser += AuthenticationActiveDirectoryProvider_CustomCreateUser;

xaf-how-to-sort-a-listview-in-code/CS/WinWebSolution.Web/ApplicationCode/WebApplication.cs#L73

this.Modules.Add(this.securityModule1);
this.Security = this.securitySimple1;
this.DatabaseVersionMismatch += new System.EventHandler<DevExpress.ExpressApp.DatabaseVersionMismatchEventArgs>(this.WinWebSolutionAspNetApplication_DatabaseVersionMismatch);

xaf-how-to-implement-a-custom-security-operation-that-can-be-permitted-at-the-type-level/CS/CustomSecurityOperation.Web/WebApplication.cs#L67

this.Modules.Add(this.securityModule1);
this.Security = this.securityStrategyComplex1;
this.DatabaseVersionMismatch += new System.EventHandler<DevExpress.ExpressApp.DatabaseVersionMismatchEventArgs>(this.CustomSecurityOperationAspNetApplication_DatabaseVersionMismatch);

xaf-how-to-implement-a-security-system-user-based-on-an-existing-business-class/CS/EmployeeAsUserExample.Web/WebApplication.cs#L56

this.Modules.Add(this.securityModule1);
this.Security = this.securityStrategyComplex1;
this.DatabaseVersionMismatch += new System.EventHandler<DevExpress.ExpressApp.DatabaseVersionMismatchEventArgs>(this.EmployeeAsUserExampleAspNetApplication_DatabaseVersionMismatch);

xaf-separate-employees-data-in-different-departments-using-security-permissions/CS/MainDemo.Web/WebApplication.cs#L67

this.Modules.Add(this.module3);
this.Security = this.securityStrategyComplex1;
this.DatabaseVersionMismatch += new System.EventHandler<DevExpress.ExpressApp.DatabaseVersionMismatchEventArgs>(this.MainDemoAspNetApplication_DatabaseVersionMismatch);

VB.NET

XAF_how-to-allow-a-user-to-select-the-authentication-type-at-runtime-e2371/VB/E2371.Module/SetupAuthenticationHelper.vb#L21

Dim authenticationStandardProvider As New CustomAuthenticationStandardProvider(application.Security.UserType)
Dim authenticationActiveDirectoryProvider As New AuthenticationActiveDirectoryProvider(application.Security.UserType, CType(application.Security, ICanInitializeNewUser), True)
AddHandler authenticationActiveDirectoryProvider.CustomCreateUser, AddressOf AuthenticationActiveDirectoryProvider_CustomCreateUser

xaf-how-to-sort-a-listview-in-code/VB/WinWebSolution.Web/ApplicationCode/WebApplication.vb#L75

            Me.Modules.Add(Me.securityModule1)
            Me.Security = Me.securitySimple1
'INSTANT VB NOTE: The following InitializeComponent event wireup was converted to a 'Handles' clause:

xaf-how-to-use-data-from-security-in-criterion/VB/CustomFunctionCriteriaOperator.Web/WebApplication.vb#L80

Me.Modules.Add(Me.module5)
Me.Security = Me.securityStrategyComplex1
DirectCast(Me, System.ComponentModel.ISupportInitialize).EndInit()

xaf-how-to-implement-a-custom-security-operation-that-can-be-permitted-at-the-type-level/VB/CustomSecurityOperation.Web/WebApplication.vb#L68

            Me.Modules.Add(Me.securityModule1)
            Me.Security = Me.securityStrategyComplex1
'INSTANT VB NOTE: The following InitializeComponent event wireup was converted to a 'Handles' clause:

xaf-how-to-implement-a-security-system-user-based-on-an-existing-business-class/VB/EmployeeAsUserExample.Web/WebApplication.vb#L58

Me.Modules.Add(Me.securityModule1)
Me.Security = Me.securityStrategyComplex1
DirectCast(Me, System.ComponentModel.ISupportInitialize).EndInit()