MacroSettings Class

Settings for resolving macros

Inheritance Hierarchy

System.Object
  CMS.MacroEngine.MacroSettings

Namespace: CMS.MacroEngine
Assembly: CMS.MacroEngine (in CMS.MacroEngine.dll) Version: 8.2.23

Syntax

public class MacroSettings

The MacroSettings type exposes the following members.

Constructors

	Name	Description
Public method	MacroSettings	Constructor

Methods

	Name	Description
Public method	AddCacheDependencies	Adds the cache dependencies to the macro context
Public method	AddFileCacheDependencies	Adds the cache dependencies to the macro context
Public method	Clone	Returns the clone of the current context

Extension Methods

	Name	Description
Public Extension Method	AsValue	Converts object to a query value which can be used as a query parameter (Defined by QueryExtensions.)
Public Extension Method	GetAPIString	Gets the string by the specified resource key (Defined by CoreExtensions.)
Public Extension Method	GetString	Gets the string by the specified resource key (Defined by CoreExtensions.)
Public Extension Method	ToBoolean	Returns the boolean representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToDateTime	Returns the DateTime representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToDouble	Returns the double representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToGuid	Returns the Guid representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToInteger	Returns the integer representation of an object or default value if not. (Defined by CoreExtensions.)
Public Extension Method	ToString	Returns the string representation of an object or default value if not. (Defined by CoreExtensions.)

Properties

	Name	Description
Public property	AllowContextMacros	If true, the properties from contexts are not resolved unless explicitly registered.
Public property	AllowRecursion	If true, the recursion is allowed within the macro resolving. Default value is true.
Public property	AvoidInjection	If true, the resolving of the macros should avoid SQL injection (escapes the apostrophes in output). Default value is false
Public property	CacheDependencies	Outputs the cache dependencies collected during the processing
Public property	Culture	Culture used for the resolving
Public property	DisableContextMacros	If true, all the context macros are disabled (only base MacroResolver sources are checked).
Public property	DisableContextObjectMacros	If true, context objects (such as ForumContext, CommunityContext, CMSContext, ...) will not be resolved.
Public property	DisablePageContextMacros	If true, page context macros are not available (CurrentDocument, CurrentPageInfo).
Public property	EncapsulateMacroObjects	If true, the object will be encapsulated to its macro representations
Public property	EncodeResolvedValues	If true, the resolved macro values are encoded to avoid XSS. Default value is false
Public property	EvaluationTimeout	Expression evaluation timeout in milliseconds. If the evaluation time exceeds this time, evaluation will be aborted and the result will be null.
Public property	FileCacheDependencies	Outputs the file cache dependencies collected during the processing
Public property	CheckIntegrity	If true, the integrity of security parameters is checked within macro evaluation.
Public property	CheckSecurity	If true, the security is checked within macro evaluation
Public property	KeepUnresolvedMacros	If true, unresolved macros are kept in their original form.
Public property	MaxRecursionlevel	Gets or sets the maximal recursion level.
Public property	RelatedObject	Related object allows set object used for resolving in macro method. Used in web part properties.
Public property	TrackCacheDependencies	If true, the resolving tracks cache dependencies. Default value is false
Public property	UserName	Gets or sets the name of the user which will be used to verify security when CheckIntegrity is false.
Public property	VirtualMode	If true, the virtual mode is enabled for the macro resolver, meaning that the resolver always tries to return non-null values. Instead, empty objects are provided.