AccessSettings.TrySetRules(IAccessRule[]) Method

Sets resource access rules.

Namespace: DevExpress.Security.Resources

Assembly: DevExpress.Data.v19.1.dll

Declaration

C#

public bool TrySetRules(
    params IAccessRule[] rules
)

VB.NET

Public Function TrySetRules(
    ParamArray rules As IAccessRule()
) As Boolean

Parameters

Name	Type	Description
rules	IAccessRule[]	An array of access rules.

Returns

Type	Description
Boolean	true, if the specified rule collection is registered successfully. Otherwise, false.

Remarks

Before you set access rules, specify the resources for which these rules should be checked. To do this, use one of the following static properties:

• StaticResources

  C#

  // Images can be loaded only from the "C:\\StaticResources\\" file directory and "http://mysite.dev" site
  DevExpress.Security.Resources.AccessSettings.StaticResources.TrySetRules(DirectoryAccessRule.Allow("C:\\StaticResources\\"), UrlAccessRule.Allow("http://mysite.dev"));
  

  VB.NET

  ' Images can be loaded only from the "C:\\StaticResources\\" file directory and "http://mysite.dev" site
  DevExpress.Security.Resources.AccessSettings.StaticResources.TrySetRules(DirectoryAccessRule.Allow("C:\\StaticResources\\"), UrlAccessRule.Allow("http://mysite.dev"))
  

• DataResources

  C#

  // JSON data can be loaded only from URLs; Excel data cannot be loaded from file directories (Excel data load from URLs is not supported)
  DevExpress.Security.Resources.AccessSettings.DataResources.TrySetRules(UrlAccessRule.Allow(), DirectoryAccessRule.Deny()); 
  

  VB.NET

  ' JSON data can be loaded only from URLs; Excel data cannot be loaded from file directories (Excel data load from URLs is not supported)
  DevExpress.Security.Resources.AccessSettings.DataResources.TrySetRules(UrlAccessRule.Allow(), DirectoryAccessRule.Deny())
  

• ReportingSpecificResources

  C#

  // Style sheets cannot be loaded from file directories; only XML report layout serialization format is allowed
  DevExpress.Security.Resources.AccessSettings.ReportingSpecificResources.TrySetRules(DirectoryAccessRule.Deny(), SerializationFormatRule.Deny(SerializationFormat.Xml));
  

  VB.NET

  ' Style sheets cannot be loaded from file directories; only XML report layout serialization format is allowed
  DevExpress.Security.Resources.AccessSettings.ReportingSpecificResources.TrySetRules(DirectoryAccessRule.Deny(), SerializationFormatRule.Allow(SerializationFormat.Xml))
  

The TrySetRules(IAccessRules[]) method can be called only once during the application run. This allows rules not to be overridden. So, call this method when the application starts to specify rules before a control (for example, Web End-User ReportDesigner) sets its rules. Otherwise, the TrySetRules(IAccessRules[]) method does not register the specified rule collection and returns false.

You can use the SetRules(IAccessRule[]) method to set access rules. This method raises an exception if a control sets its rules earlier.