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

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

This abstract class acts as a base class for all classes that renders its content depending on the caller's access rights to an object.
Inheritance Hierarchy

SystemObject
  ContentStudio.SiteCodeBase
    ContentStudio.Site.ActiveScriptingActiveScriptingBase
      ContentStudio.Site.ActiveScriptingSecurityBase
        ContentStudio.Site.ActiveScripting.SecurityPermissionDependentComponent
          ContentStudio.Site.ActiveScripting.SecurityInsertLinkByPermission
          ContentStudio.Site.ActiveScripting.SecurityInsertLinkIfWritePermission

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

public abstract class PermissionDependentComponent : SecurityBase

The PermissionDependentComponent type exposes the following members.

Constructors

  NameDescription
Protected methodPermissionDependentComponent
Initializes a new instance of the PermissionDependentComponent class
Top
Properties

  NameDescription
Public propertyAccessMask
Sets or gets the permission or combination of permissions to check for. The default value is CSObjectPermissions.Read.
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 propertyComponentName
Gets the name of the component
(Inherited from ActiveScriptingBase.)
Public propertyConformance
Gets a value which specifies which type of code a component can generate.
(Inherited from ActiveScriptingBase.)
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 propertyElementType
Gets a value which specifies the type of outer element the component generates.
(Inherited from ActiveScriptingBase.)
Public propertyEncoding
Sets or gets the encoding the component uses. The default encoding is the UTF8 encoding without byte order mark.
(Inherited from ActiveScriptingBase.)
Protected propertyObjectToCheck
Sets or gets a value that indicates the id of the Content Studio object to perform the access check on. The default value is 1.
Protected propertyObjectType
Sets or gets a value that indicates what type of object that is referenced in the ObjectToCheck property. The caller's permission will be checked against this object when the derived class calls the Invoke method. The default value is CSSecurableObjects.DocumentItem.
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.)
Top
Methods

  NameDescription
Protected methodAccessCheck
Performs an access check when the Invoke method is called, based on the value of the ObjectToCheck, AccessMask and ObjectType properties.
Public methodAccessCheckForCurrentCategory
Determines if access us granted to the current category for the calling user.
(Inherited from SecurityBase.)
Public methodAccessCheckForCurrentDocument
Determines if access us granted to the current document for the calling user.
(Inherited from SecurityBase.)
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
Invokes the component. Derived classes call the overloaded Invoke method from this method, passing a reference to the PermissionDependentComponent derived class that should receive the OnRender event.
Protected methodInvoke(PermissionDependentComponent)
Invokes the component by performing the checks and reporting the result to the OnRender event handler of the derived class.
Protected methodMemberwiseClone (Inherited from Object.)
Protected methodOnRender
Target for the OnRender event, that renders the content to the specified output stream.
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.)
Top
Remarks

When deriving from this class you must implement the OnRender event handler and the public Invoke method. In your implementation of the Invoke method you can set properties in the base class and finally you call the protected overloaded version of the Invoke passing a reference to the class instance (this). The actual work is done in the OnRender event that will automatically be raised by the base class after that the access check has been made. It is also possible to provide your own access check mechanism by overriding the AccessCheck method.
See Also

Reference