This document is provided on an "AS IS" basis without warranties of any kind. Smartsite iXperion class libraries may change in future releases.

Syntax

C# Copy imageCopy Code
                                  public sealed class CmsViperModule
Visual Basic (Declaration) Copy imageCopy Code
                                  Public NotInheritable Class CmsViperModule

The type exposes the following members.

Public Methods

  Name Description
Public method AddAIMRelation
Adds an item to the AIM relations collection.
(Inherited from Module.)
Public method Static member AddAssetItem Overloaded.
Public method Static member AddAssetItemFromXml
Adds an Asset Item.
Public method Static member AddMultipleAssetItems
Creates multiple asset items from the urls specified within the xml data.
Public method ApplyProperties
Applies the properties from the SXML processing environment into the current module.
(Inherited from BaseModule.)
Public method BeginExecute
Override this to execute code before Execute() is fired.
Last point to add data to the Cache Signature.
(Inherited from Module.)
Public method Capture
Passes an SXML subtree to the current module.
(Inherited from BaseModule.)
Public method CheckTimeout
Checks whether execution has timed out, given the setting of TimeoutMilliseconds()()()().
(Inherited from BaseModule.)
Public method Static member ChildCount
Returns the number of direct children of the given item
Public method ClearForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method Static member ContentTypes
Gets the content types.
Public method Static member DeleteAssetFiles
Deletes the specified Asset Items and any referenced files.
Public method Dispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from BaseModule.)
Public method DoPreparse
Check whether to preparse data in the given property.
(Inherited from BaseModule.)
Public method DoRecurseTag
Determines whether to recurse on a given tag
Public method EndExecute
Override this to execute code after Execute() is fired.
(Inherited from Module.)
Public method Equals (Inherited from Object.)
Public method EvaluatePropertyExpression
Evaluates an expression in a property with Expression Syntax
(Inherited from Module.)
Public method Execute
Execute the macro. Should be overridden by inherited class.
(Inherited from Module.)
Public method ExecuteRawParameter
Executes the data of a raw parameter.
(Inherited from Module.)
Public method ExistsBuffer
Checks whether a local buffer exists.
(Inherited from BaseModule.)
Public method Find
Finds the specified child module.
(Inherited from BaseModule.)
Public method FindExtension
Finds an extension macro.
(Inherited from BaseModule.)
Public method GetAIMRelations
Gets a list of all outgoing AIM relations created by the macro.
(Inherited from BaseModule.)
Public method Static member GetAssetDerivedItem Overloaded.
Public method Static member GetAssetDerivedItems
Returns all derived images for a given asset.
Public method Static member GetAssetFolderConfigurationNode
Gets the Asset Folder configuration xml for the specified asset folder.
Public method Static member GetAssetFolderNameByRootItem
Gets the Asset Folder Name for the specified Asset Root Item.
Public method Static member GetAssetItemNumber
Returns the item number of the corresponding asset item when the specified location refers to an asset item.
Public method Static member GetAssetLocation
Gets the Asset location for the specified item.
Public method GetBuffer
Gets a local buffer.
(Inherited from BaseModule.)
Public method Static member GetChild Overloaded.
Public method Static member GetChildren
Gets the children of the specified item.
Public method GetException
Returns the text message of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetExceptionSmartsiteCode
Returns the Smartsite Error code of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetExceptionString
Returns the full information of the exception that has occurred, including the stack trace.
(Inherited from BaseModule.)
Public method GetExceptionType
Returns the full Type name of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetForcedResult
Gets the forced result of the macro, set by overriding the normal rendering using SetForcedResult().
(Inherited from Module.)
Public method GetHashCode (Inherited from Object.)
Public method GetInnerException
Returns the text message of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetInnerExceptionSmartsiteCode
Returns Smartsite error code of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetInnerExceptionString
Returns the full information of the inner exception of the exception that has occurred, including the stack trace.
(Inherited from BaseModule.)
Public method GetInnerExceptionType
Returns the full Type name of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method Static member GetIsInSubTreeWhereClause Overloaded.
Public method Static member GetItemByTitlePath Overloaded.
Public method Static member GetItemCode
Returns the item code of the item with the given number.
Public method Static member GetItemNumber Overloaded.
Public method Static member GetLevel
Returns the hierarchic depth of the given item.
Public method Static member GetLocalItemCode
Returns the publication-independant part of the item code.
Public method Static member GetNotInSubTreeWhereClause Overloaded.
Public method GetParameter
Gets the value of the given parameter/property.
(Inherited from BaseModule.)
Public method GetParameter
Gets the value of the given parameter/property.
(Inherited from BaseModule.)
Public method GetParent Overloaded.
Public method Static member GetParentItem
Returns the item number of the item's parent.
Public method Static member GetPublication Overloaded.
Public method Static member GetPublicationChannel Overloaded.
Public method GetRenderTime
Returns the render time of the macro in milliseconds.
(Inherited from Module.)
Public method Static member GetRepository Overloaded.
Public method GetResult
Returns the result of the macro.
Typically used in the ResultFormat property, to format, convert or encode the result.
(Inherited from BaseModule.)
Public method GetResult
Returns the result of the macro.
Typically used in the ResultFormat property, to format, convert or encode the result.
(Inherited from BaseModule.)
Public method Static member GetSourceLocation
Gets the Asset source location for the specified item. If not available or empty, the Asset location is returned.
Public method Static member GetSubTreeItemNumber
Gets the closest related sub tree for the given item.
Public method Static member GetSubTreesList
Gets a list of all sub trees the given item belongs to.
Public method Static member GetTranslationArg Overloaded.
Public method Static member GetTranslationArgCount
Returns the number of unnamed arguments to the translation.
Valid only within the 'replacement' field in translation items.
Public method Static member GetTranslationBase
Returns the contents of the translation the current translation overrides.
Valid only within the 'replacement' field in translation items.
Public method Static member GetTranslationCaller Overloaded.
Public method Static member GetTranslationName
Returns the name of the current translation.
Valid only within the 'replacement' field in translation items.
Public method Static member GetTranslationNumber
Returns the item number of the current translation.
Valid only within the 'replacement' field in translation items.
Public method Static member GetTranslationOutParameter
Gets the given out parameter value.
Valid only within the 'replacement' field in translation items.
Public method Static member GetTranslationScopeNew
Returns the scope of the current translation.
Valid only within the 'replacement' field in translation items.
Public method GetType (Inherited from Object.)
Public method Initialize
Called to initialize this Module
(Inherited from BaseModule.)
Public method Static member IsAssetItemReference
Determines if the specified location refers to an Asset Item.
Public method IsChildOf Overloaded.
Public method Static member IsDeleteAllowed
Determines if the specified Asset Item's AssetFolder configuration allows deletion of items.
Public method Static member IsDescendantOf
Returns true if the given item is a child of the given parent.
Public method Static member IsFolderItem
Returns true if the given item is a folder.
Public method Static member IsMemberOfAnySubTrees
Determines whether the specified item is a member of any of the given sub trees.
Public method Static member IsMemberOfSpecifiedSubTree
Determines whether the specified item is a member of the given sub tree.
Public method Static member IsTranslationPreview
Determines whether the current translation is being previewed using its own logic.
Public method ParameterExists
Checks whether the given parameter/property is set.
(Inherited from BaseModule.)
Public method PreInitialize
Called just before initialization of the module
(Inherited from Module.)
Public method ReadyExecuting
Method that is called after the module has executed.
(Inherited from Module.)
Public method Static member ReturnFromTranslation
Returns immediately from a translation, with the given result.
Note that standard replacement output of the translation will not be used when using translation.return(). You must use translation.setresult(), translation.setnullresult(), or the returnValue argument of translation.return().
Public method ScopeTerminated
Executed when the module is about to get out of scope.
(Inherited from BaseModule.)
Public method SetBuffer
Sets a local buffer.
(Inherited from BaseModule.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method Static member SetTranslationNullResult
Sets the current translation result to null, allowing the default parameter of the translation call to work.
Valid only within the 'replacement' field in translation items.
Public method Static member SetTranslationOutParameter
Sets the given out parameter value.
Valid only within the 'replacement' field in translation items.
Public method Static member SetTranslationResult
Sets the current translation result to the given value. Overrules the standard output a translation generates.
Valid only within the 'replacement' field in translation items.
Public method Static member StartSynchronize
Starts the AssetFolder synchronization (through the configured scheduled job).
Public method TestCondition
Tests whether execution should take place based on the expression in the condition property
(Inherited from Module.)
Public method TestPropertyExpression
Tests whether an expression in a property with Expression Syntax evaluates to true.
(Inherited from Module.)
Public method ThrowCurrentException
Makes Smartsite throw the current exception.
(Inherited from BaseModule.)
Public method ThrowInnerException
Makes Smartsite throw the inner exception.
(Inherited from BaseModule.)
Public method ToString
Returns a string that represents the current macro.
(Inherited from Module.)
Public method ToString
Returns a String that represents the current Object.
(Inherited from Module.)
Public method Static member UpdateAssetItem
Updates an Asset Item.
Public method Static member ValidateFile
Validates the specified file.

Protected Methods

  Name Description
Protected method Finalize (Inherited from Object.)
Protected method IsBufferName
Determines whether the data is a buffer name.
(Inherited from Module.)
Protected method IsSingleSaveBuffername
Determines whether a single save buffername is used.
(Inherited from Module.)
Protected method MemberwiseClone (Inherited from Object.)
Protected method SetCurrentProperty
Sets the current property.
(Inherited from BaseModule.)

Protected Fields

  Name Description
Protected field DoExecute
Specifies whether to execute the module
(Inherited from BaseModule.)
Protected field InternalAIMMode
Cotnains the internal AIM mode.
(Inherited from Module.)
Protected field InternalCopyFormatting
The id of the macro to copy the formatting settings from.
(Inherited from Module.)
Protected field InternalFormatting
Formatting settings.
(Inherited from Module.)
Protected field ResolvingSaveBuffers
True when save buffers are evaluated.
(Inherited from BaseModule.)
Protected field savingUnformattedResult
True when save buffers are checked before formatting is applied, to facilitate unformated data to be saved.
(Inherited from BaseModule.)

Public Properties

  Name Description
Public property AcceptsInnerXml
Returns true if the module currently accepts string data within the macro tags.
(Inherited from BaseModule.)
Public property AccessDeniedReturnValue
Gets or sets the value that is returned when the site visitor has insufficient access.
(Inherited from Module.)
Public property AIMMode
Gets or sets the AIM scanning mode of the macro.
(Inherited from Module.)
Public property AIMOrigin
Returns the current AIM source. If AIMMode is Autonomous, the current instructionsource is used, otherwise the current item.
(Inherited from Module.)
Public property BufferNames
Gets or sets the buffer names.
(Inherited from Module.)
Public property Condition
Gets or sets the Viper expression to evaluate before actually executing the macro.
If the expression returns false, the execution of the module and its child modules is skipped.
(Inherited from Module.)
Public property ConditionMatched
Must return true if TestCondition() matched.
(Inherited from Module.)
Public property CurrentCacheModule
Returns a reference to the current cache module, if the current instruction is encapsulated by a cache block.
(Inherited from Module.)
Public property CurrentProperty
Gets the property currently being set on the module.
(Inherited from BaseModule.)
Public property DefaultValue
Gets or sets the default value that will be returned when the execution would otherwise return an empty string.
(Inherited from Module.)
Public property Formatting
Gets the formatting options.
(Inherited from Module.)
Public property HasParameterSection
Returns true if the macro currently uses an SXML parameters section
(Inherited from BaseModule.)
Public property Id
Gets or sets the unique id of the module instance during the current processing.
Modules with Id set will be kept alive during the complete rendering and can be accessed from other modules using the Find method.
(Inherited from BaseModule.)
Public property IsCancelled
Gets a value indicating whether the execution of the macro is cancelled.
(Inherited from BaseModule.)
Public property IsSelfClosing
Gets a value indicating whether this instance is self closing.
(Inherited from BaseModule.)
Public property LocalId
Gets or sets the local id of the macro in the current buffer scope.
(Inherited from Module.)
Public property MinimumAccessTypeLevel
Friendly name of the minimum access type level required by the site visitor to execute this macro.
(Inherited from Module.)
Public property ModuleInfo
Gets the module info.
(Inherited from BaseModule.)
Public property OnErrorReturnValue
Gets or sets the value to return in case on error occurs during execution.
The Viper expressions this.error(), this.error(full) and this.error(type) are available in this context.
(Inherited from Module.)
Public property Properties
Gets the full list of properties as set when executing the module.
(Inherited from BaseModule.)
Public property Remarks
Gets or sets the remarks. Remarks have no effect on the actual execution of the module.
They only improve the readability of the code.
(Inherited from BaseModule.)
Public property Result
Returns a reference to the module result
(Inherited from BaseModule.)
Public property ResultFormat
Gets or sets the resultformat.
(Inherited from Module.)
Public property ResultType
Gets or sets the type of the result.
(Inherited from BaseModule.)
Public property State
Gets a key/value collection that can be used to organize and share data during the lifecycle of a module.
(Inherited from BaseModule.)
Public property Status
Gets a value indicating the ModuleStatus of this module.
(Inherited from BaseModule.)
Public property SXMLPath
Gets the path to the macro in the current execution stack.
(Inherited from BaseModule.)
Public property TimeoutSeconds
Gets or sets the timeout in seconds. In the overriden Execute() method, you can call CheckTimeout() to check whether execution has timed out.
(Inherited from BaseModule.)
Public property Trim
Gets a value indicating how the whitespace is trimmed.
(Inherited from BaseModule.)
Public property TypeName
Gets the name of the Module type.
(Inherited from BaseModule.)
Public property UserSetPropertyList
Gets the user-set property list.
(Inherited from BaseModule.)
Public property Whitespace
Gets a value indicating whether to preserve whitespace.
(Inherited from BaseModule.)

Protected Properties

  Name Description
Protected property IContext
Gets a reference to the IContext interface.
(Inherited from BaseModule.)

Public Events

  Name Description
Public event SetProperty
Event fired just before setting a property on the Module instance from the SXML processor.
(Inherited from BaseModule.)
Public event StatusChange
Event raised when the execution status changes.
(Inherited from BaseModule.)

Explicit Interface Implementations

See Also

Advanced