WebMapAZ Class Content Studio 5.7 SDK
Content Studio Web Content Management System

[This is preliminary documentation and is subject to change.]

Writes a web map (implemented as a list) to the supplied stream or the default response stream.
Inheritance Hierarchy

SystemObject
  ContentStudio.SiteCodeBase
    ContentStudio.Site.ActiveScriptingActiveScriptingBase
      ContentStudio.Site.ActiveScriptingMenuBase
        ContentStudio.Site.ActiveScripting.MenuWebMapAZ

Namespace: ContentStudio.Site.ActiveScripting.Menu
Assembly: CS_SiteLib (in CS_SiteLib.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax

public class WebMapAZ : MenuBase

The WebMapAZ type exposes the following members.

Constructors

  NameDescription
Public methodWebMapAZ
Constructs a new instance of the WebMapAZ class that writes to the default response stream
Public methodWebMapAZ(Stream)
Constructs a new instance of the WebMapAZ class that writes to the supplied stream
Top
Properties

  NameDescription
Public propertyApplicationCacheTimeOut
Sets or gets the timeout (in minutes) for the application cache to live before it is refreshed. The default value is 240.
Public propertyBackwardsComponentCompatibilityMode
Sets or gets a value that indicates whether the code runs in backwards compatibility component mode. The default value is false.
(Inherited from ActiveScriptingBase.)
Public propertyCacheName
Sets or gets a value that identifies the component on the entire web site. This name MUST be unique within the site since it is used to store application or session cache data. The default value is WebMapAZ1
Public propertyCacheType
Sets or gets the the type of caching to use for the web map. The default value is CacheTypes.None
Public propertyComponentCount
Sets or gets the ordinal number of the component on the page. This value can be used by the component internally to make sure that it can generate unique values for example ID on HTML elements.
Public propertyComponentName
Gets the name of the component
(Overrides ActiveScriptingBaseComponentName.)
Public propertyConformance
Gets a value which specifies which type of code a component can generate.
(Overrides ActiveScriptingBaseConformance.)
Protected propertyCode exampleCS_DataFields
Gets a EPTXmlParser that contains a collection of EPT field definitions and values. This property is the replacement for the obsolete EPT_GetFieldName(String) and EPT_GetFieldValue(String) methods.
(Inherited from CodeBase.)
Public propertyCSSPrefix
Sets or gets the prefix of the CSS classes that are generated. The default value is "CS_DefaultWebMap".
Public propertyDocumentID
Sets or gets the id of the document that acts as the root of the generated web tree. The root document is normally not included in the web map. The default value is zero in wich case the root document is determined from the passed in identifier in the query string.
Public propertyElementType
Gets a value which specifies the type of outer element the component generates.
(Overrides ActiveScriptingBaseElementType.)
Public propertyEncoding
Sets or gets the encoding the component uses. The default encoding is the UTF8 encoding without byte order mark.
(Inherited from ActiveScriptingBase.)
Public propertyHeaderLevel
Sets or gets the header level. This property regulates the level of the head (h) tag written. This header holds the first letter of a found item one for each found start letter. Ex. HeaderLevel 2 generates a <h2> tag The default value is 2 and values can be in the interval 1 - 6.
Protected propertyPage
A reference to the current context page. This will initialize in the constructor of this class.
(Inherited from CodeBase.)
Protected propertyRunningUserControl
Gets the current running user control.
(Inherited from CodeBase.)
Public propertySkipToContentText
Sets or gets the text that is shown in the skip to content link at the top of the control. The default value is "Skip to content".
Public propertySortCulture
Sets or gets a value that identifies the culture to use when sorting the entries found. The default value is an empty string which causes WebMapAZ to use the culture of the current thread. For more information see the .NET documentation about the System.Globalization.CultureInfo class.
Top
Methods

  NameDescription
Protected methodBuildHTMLComponentException
Returns an component exception in HTML format.
(Inherited from ActiveScriptingBase.)
Public methodEquals (Inherited from Object.)
Protected methodFinalize (Inherited from Object.)
Protected methodGenerateLinkTargetAttribute
Returns the attribute string to be written to the link.
(Inherited from ActiveScriptingBase.)
Protected methodGetCorrectField
Extracts the correct value from a passed in EPT field name and a static field value.
(Inherited from ActiveScriptingBase.)
Public methodGetHashCode (Inherited from Object.)
Public methodGetType (Inherited from Object.)
Public methodInvoke
Protected methodMemberwiseClone (Inherited from Object.)
Protected methodReadFromApplicationCache
Returns data that is read from the application cache.
(Inherited from ActiveScriptingBase.)
Protected methodSetApplicationCache
Stores a string in the application cache.
(Inherited from ActiveScriptingBase.)
Protected methodSyncronizeMLC
Provides support for components that needs to be MLC aware, by localizing the supplied category or presentation template from the current document, or the preferred language of the visitor.
(Inherited from ActiveScriptingBase.)
Public methodToString (Inherited from Object.)
Protected methodWriteAttribute(TextWriter, String, String)
Writes an attribute string to the supplied stream, unless Value is an empty string or null
(Inherited from ActiveScriptingBase.)
Protected methodWriteAttribute(TextWriter, String, String, Boolean)
Writes an attribute string to the supplied stream.
(Inherited from ActiveScriptingBase.)
Protected methodCode exampleWriteOverview
Writes the overview part of the web map. This method is called via the Invoke method. Inheriting classes can override this method to supply their own rendering code
Protected methodCode exampleWriteSections
Write sections of document, grouped on their first letter, for the web map. This method is called via the Invoke method. Inheriting classes can override this method to supply their own rendering code
Top
Remarks

The generated code consists of a list at the top with a SkipToContent link followed by a series of links to each one of the letter sections that follows. The skip link leads to the first of the letter sections. There will be two sections implemented as UL lists, starting with an index that contains links to the actual web map with links to documents grouped by their initial letters.
The letter sections consist of a header with the first letter of the following documents and all documents starting with the same letter. The source document is a hierarchy of documents, and the root document of this hierarchy must be specified.
The WebMapAZ class acts as the underlying engine for the Web map A-Z 2.0 AS component. To use this class, create an instance of this object, and call the Invoke method with an appropriate set of parameters.
This class can throw exceptions, thus your code should be wrapped within try/catch statements in order to avoid the entire page to crash.
The generated code is fully HTML/XHTML strict compatible.
During rendering, a number of CSS classes are inserted to enable formatting of the generated web map. Make sure that the following classes exists in your CSS stylesheet:
CSS ClassDescription
CSSPrefix_IndexApplies on the UL list that builds the index at the top.
CSSPrefix_SkipLinkApplies to the LI element that contains the skip link that navigates to actual Web Map.
CSSPrefix_ContentListsApplies to the DIV element that contains the UL list that forms the Web Map.
  • CSSPrefix is a placeholder for the CSSPrefix parameter.
    To prevent these classes from beeing written out omit or set the CSSPrefix property to Empty.
See Also

Reference