Class ContentRenderer
Webcontrol for BlockData. The control with create a child control with the selected render for the block type.
Inheritance
Namespace: EPiServer.Web.WebControls
Assembly: EPiServer.dll
Version: 8.11.0Syntax
public class ContentRenderer : WebControl, IContentSource, INamingContainer
Constructors
ContentRenderer()
Initializes a new instance of the ContentRenderer class.
Declaration
public ContentRenderer()
Properties
AttributeAssembler
Declaration
public Injected<ContentFragmentAttributeAssembler> AttributeAssembler { get; set; }
Property Value
Type | Description |
---|---|
Injected<ContentFragmentAttributeAssembler> |
ContentAreaItem
Gets or sets the content area item.
Declaration
public ContentAreaItem ContentAreaItem { get; set; }
Property Value
Type | Description |
---|---|
ContentAreaItem |
CurrentContent
Gets or sets the current content.
Declaration
public IContent CurrentContent { get; set; }
Property Value
Type | Description |
---|---|
IContent |
CurrentControl
Gets or sets the block, which will be rendered.
Declaration
public Control CurrentControl { get; set; }
Property Value
Type | Description |
---|---|
System.Web.UI.Control |
CurrentData
Gets or sets the block, which will be rendered.
Declaration
public IContentData CurrentData { get; set; }
Property Value
Type | Description |
---|---|
IContentData |
CustomTagName
Gets or sets the tag name. If not set a div-tag will be used.
Declaration
public string CustomTagName { get; set; }
Property Value
Type | Description |
---|---|
System.String |
IsCircularReference
Gets or sets a value indicating whether the CurrentControl is in a chain with circular references.
Declaration
public bool IsCircularReference { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
LocalizationService
Gets or sets the localization service.
Declaration
protected Injected<LocalizationService> LocalizationService { get; set; }
Property Value
Type | Description |
---|---|
Injected<LocalizationService> | The localization service. |
RenderSettings
Gets or sets the render settings that should be passed on to the content template.
Declaration
public IDictionary<string, object> RenderSettings { get; set; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IDictionary<System.String, System.Object> |
Remarks
Note that the Tag property must be used to affect the template selection even if the RenderSettings dictionary contains a Tag or DisplayOptions (with Tag) entry.
RenderType
Sets the RenderType for the ContentRenderer.
Declaration
public RenderType RenderType { get; set; }
Property Value
Type | Description |
---|---|
RenderType | A RenderType that is used to specify how the ContentRenderer should be rendered. |
Tag
Gets or sets the current tag.
Declaration
public string Tag { get; set; }
Property Value
Type | Description |
---|---|
System.String |
TagName
Declaration
protected override string TagName { get; }
Property Value
Type | Description |
---|---|
System.String |
TemplateControlLoader
Gets or sets the template control loader, which will be used to find the correct controller for rendering the block.
Declaration
public Injected<TemplateControlLoader> TemplateControlLoader { get; set; }
Property Value
Type | Description |
---|---|
Injected<TemplateControlLoader> |
Methods
CreateChildControls()
The TemplateControlLoader will try to resolve the block control, which will be added to control collection.
Declaration
protected override void CreateChildControls()
DataBind()
Binds a data source to the ContentRenderer and all its child controls.
Declaration
public override void DataBind()
EnsureChildControlsCreated()
Ensures that the child controls have been created, or create them.
Declaration
public void EnsureChildControlsCreated()
Get<T>(ContentReference)
Retrieves a IContent object with information about a content, based on the ContentReference parameter.
Declaration
public T Get<T>(ContentReference contentLink)
where T : IContentData
Parameters
Type | Name | Description |
---|---|---|
ContentReference | contentLink | Reference to the content being retrieved |
Returns
Type | Description |
---|---|
T | IContent object requested |
Type Parameters
Name | Description |
---|---|
T |
GetChildren<T>(ContentReference)
Retrieve a IContent listing
Declaration
public IEnumerable<T> GetChildren<T>(ContentReference contentLink)
where T : IContentData
Parameters
Type | Name | Description |
---|---|---|
ContentReference | contentLink | Reference to parent content |
Returns
Type | Description |
---|---|
System.Collections.Generic.IEnumerable<T> | Returns a collection of IContent directly below the content referenced by the ContentReference parameter. |
Type Parameters
Name | Description |
---|---|
T |
RenderBeginTag(HtmlTextWriter)
Renders the HTML opening tag of the control to the specified writer if there is a current control available or if in edit mode.
Declaration
public override void RenderBeginTag(HtmlTextWriter writer)
Parameters
Type | Name | Description |
---|---|---|
System.Web.UI.HtmlTextWriter | writer | A System.Web.UI.HtmlTextWriter that represents the output stream to render HTML content on the client. |
RenderEndTag(HtmlTextWriter)
Renders the HTML closing tag of the control into the specified writer if there is a current control available or if in edit mode.
Declaration
public override void RenderEndTag(HtmlTextWriter writer)
Parameters
Type | Name | Description |
---|---|---|
System.Web.UI.HtmlTextWriter | writer | A System.Web.UI.HtmlTextWriter that represents the output stream to render HTML content on the client. |