MacroResolver MembersKentico 8.1 API Reference
The MacroResolver type exposes the following members.
Constructors

  NameDescription
Public methodMacroResolver Obsolete.
Constructor
Protected methodMacroResolver(Boolean)
Constructor for inheritance
Back to Top
Methods

  NameDescription
Public methodAddAnonymousSourceData
Adds new anonymous data source of general type to the resolver.
Public methodAddSourceAlias
Adds alternative source expression.
Public methodClone
Clones the resolver object.
Public methodCreateChild
Creates the child resolver that loads the data from the parent resolver by default.
Public methodStatic memberEncapsulateObject
Encapsulates object if needed (DataSet, DataRow, DataTable to their Container equivalent).
Public methodOnlineEquals
Determines whether the specified OnlineObject is equal to the current OnlineObject.
(Inherited from OnlineObject.)
Protected methodOnlineFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from OnlineObject.)
Protected methodFinalizeResult
Finalizes the result (makes the result string).
Public methodGetAnonymousSources
Returns list of all aggregated anonymous sources (from the whole resolver hierarchy).
Public methodOnlineGetHashCode
Serves as a hash function for a particular type.
(Inherited from OnlineObject.)
Public methodGetHiddenRegisteredDataNames
Returns set of registered hidden named data sources (including all hidden named data sources registered in the parent(s) of the resolver, it's an union of keys through the whole hierarchy). Includes only hidden sources (which are tracked only in DevelopmentMode)
Public methodStatic memberGetInstance
Returns new instance of MacroResolver (first calls the OnGetInstance handler, if no handler is attached, new instance is created via protected constructor).
Public methodGetNamedSourceData
Gets the named source data by the given selector.
Public methodGetObjectValue(Object, Int32, EvaluationContext)
Gets the object value at given index (this is called when indexer [(int)] is used in the expression).
Public methodGetObjectValue(Object, String, EvaluationContext)
Gets the object value of specified name.
Public methodGetPrioritizedDataNames
Returns set of prioritized named data sources (including all prioritized named data sources registered in the parent(s) of the resolver, it's an union of keys through the whole hierarchy). DOES NOT include non-prioritized keys (call GetRegisteredDataNames to get those).
Public methodGetRegisteredDataNames
Returns set of registered named data sources (including all named data sources registered in the parent(s) of the resolver, it's an union of keys through the whole hierarchy). DOES NOT include prioritized keys (call GetPrioritizedDataNames to get those).
Public methodGetSourceAlias
Gets the named source data by the given selector.
Public methodOnlineGetType
Gets the OnlineType of the current instance.
(Inherited from OnlineObject.)
Public methodCheckDataSources
Checks all the data sources for the value. Returns true if given data member was found within supported data sources.
Public methodCheckObjectPermissions
Checks whether given user has Read permissions for given object type.
Public methodIsDataItemAvailable
Checks all the data sources for the value and returns true if the data item is registered.
Protected methodOnlineMemberwiseClone
Creates a shallow copy of the current OnlineObject.
(Inherited from OnlineObject.)
Public methodNamedSourceDataExists
Returns true if given source data is known (can be null, but the property has to be registered).
Protected methodPostProcessResult
If the object is InfoObject, returns its DisplayName column (if exists).
Public methodPrioritizeProperty
Prioritizes a property (equivalent to using SetNamedSourceData with last parameter true).
Public methodRegisterNamespace
Registers a namespace within this macro resolver
Public methodStatic memberRegisterObjectValueByIndexHandler
Registers GetObjectValueByName handler(s) to extend possibilities of MacroEngine to dig values from particular object types. These handlers are internally used when a property is requested out of a given object. First the default object types are checked, then all the handlers (the order of the handler evaluation is not guaranteed).
Public methodStatic memberRegisterObjectValueByNameHandler
Registers GetObjectValueByName handler(s) to extend possibilities of MacroEngine to dig values from particular object types. These handlers are internally used when a property is requested out of a given object. First the default object types are checked, then all the handlers (the order of the handler evaluation is not guaranteed).
Public methodStatic memberResolve
Resolves the context macros.
Public methodStatic memberResolveCurrentPath
Resolves the given alias path, applies the path segment to the given format string {0} for level 0.
Public methodResolveCustomMacro
Resolves the custom macro.
Public methodResolveMacroExpression(ResolveExpressionSettings)
Resolves the data macro expression (expects expression without {% %} brackets).
Public methodResolveMacroExpression(String, Boolean, Boolean, String)
Resolves the data macro expression (expects expression without {% %} brackets).
Public methodResolveMacros(String)
Resolves the macros.
Public methodResolveMacros(String, EvaluationContext)
Resolves the macros.
Public methodResolveMacros(String, MacroSettings)
Resolves all supported macro types in the given text within specified resolving context.
Public methodResolvePath
Resolves the path macro.
Public methodSetAnonymousSourceData
Sets specified data source (without name) of general type to the resolver. Replaces all the existing anonymous sources.
Public methodSetHiddenNamedSourceData(String, Func EvaluationContext, Object )
Registers the named source data with late binding. Callback is called whenever the value is needed by MacroResolver.
Public methodSetHiddenNamedSourceData(String, Object)
Registers the named source data with late binding. Callback is called whenever the value is needed by MacroResolver.
Public methodSetNamedObjectSourceDataObsolete.
Registers the named object source data. Nice name of the object is used as a selector. It's an abbreviation of calling SetNamedSourceData(infoObj.Generalized.GetNiceName(), infoObj).
Public methodSetNamedSourceData( Hashtable )
Sets hashtable data source to the resolver. Keys of the table are considered names of the data.
Public methodSetNamedSourceData( Object , Boolean)
Sets given name-value pairs to the resolver.
Public methodSetNamedSourceData(MacroField, Boolean)
Registers given field as the named source data.
Public methodSetNamedSourceData(String, Object, Boolean)
Registers the named source data. The data can be accessed with macro {%Selector.ColumnName%}. Selector has to be in identifier format.
Public methodSetNamedSourceDataCallback
Registers the named source data with late binding. Callback is called whenever the value is needed by MacroResolver.
Public methodSetNamedSourceDataInternal
Registers the named source data. The data can be accessed with macro {%Selector.ColumnName%}. Selector has to be in identifier format.
Public methodSkippedResolver
Returns true if the macro processing skipped particular resolver name
Public methodOnlineToString
Returns a string that represents the current object.
(Inherited from OnlineObject.)
Back to Top
Extension Methods

  NameDescription
Public Extension MethodAsValue
Converts object to a query value which can be used as a query parameter
(Defined by QueryExtensions.)
Public Extension MethodGetAPIString
Gets the string by the specified resource key
(Defined by CoreExtensions.)
Public Extension MethodGetString
Gets the string by the specified resource key
(Defined by CoreExtensions.)
Public Extension MethodToBoolean
Returns the boolean representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDateTime
Returns the DateTime representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDouble
Returns the double representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToGuid
Returns the Guid representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToInteger
Returns the integer representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToString
Returns the string representation of an object or default value if not.
(Defined by CoreExtensions.)
Back to Top
Fields

  NameDescription
Protected fieldmActiveMacros
Current stack of active macros (macros that are just being resolved).
Protected fieldmCurrentRecursion
Recursion handling.
Protected fieldmParentResolver
Parent resolver is used to look for the data if it's not explicitly defined in current resolver All the data available in the parent are available also in children (could be overriden, though)
Protected fieldmResolverName
Macro resolver name.
Protected fieldmSettings
Macro context.
Protected fieldmSkippedResolvers
Returns the list of resolvers that were skipped during the processing of the macros with this resolver.
Public fieldStatic memberUNRESOLVED_RETURN_VALUE
Represents unresolved keyword.
Back to Top
Properties

  NameDescription
Public propertyCulture
Culture for the resolving
Public propertyResolverName
Name of the resolver.
Public propertySettings
Macro context (settings)
Public propertyShowOnlyPrioritized
If true, only prioritized properties are shown in Macro components (IntelliSense, MacroSelector, ...). Influences only visual part of the components, resolver will still be able to resolve all the others as well.
Public propertySourceObject
Object with source data - To pass parameters to Custom macro function.
Back to Top
Events

  NameDescription
Public eventStatic memberOnGetInstance
Event raised when new instance of MacroResolver is requested.
Public eventOnGetValue
Gets value event.
Public eventStatic memberOnResolveCustomMacro
Custom macro event.
Back to Top
See Also