linuse
Jan 27, 2011
  4237
(3 votes)

Property/PropertyDataControl changes

Custom tag name

CMS 6 R2 introduces two minor changes to the Property and PropertyDataControl web controls. First it's possible to set a CustomTagName attribute on your property controls for your templates. If this value is set this will propagate to the created Property control and the default implementation for CreateDefaultControls in PropertyDataControl creates a html tag with the given name instead of just creating a span tag. For instance:

<Property runat="server" PropertyName="Pagename" CustomTagName="h1" />

will result in

<h1>[Pagename]</h1>

The property web control has support to copy it's attributes to the created web control. Since a custom tag is created with the HtmlGenericControl that does not inherit from WebControl some attributes might not be copied from the Property web control to the created tag control. Styles, attributes in the Attributes collection as well as the CssClass property are passed on to the end control. Example:

<Property runat="server" PropertyName="Pagename" CustomTagName="h1" CssClass=”myheadingclass” />

will result in

<h1 class=”myheadingclass”>[Pagename]</h1>

If you have a custom property control and want to apply the attribute copying PropertyDataControl has two overloads of a method called CopyWebAttributes that can either take a WebControl or a HtmlControl. These are virtual so that you can customize the actual attribute copying in your control.

Control creation for null value properties

Another change is that PropertyDataControl has a new protected virtual method called ShouldCreateDefaultControls. If this returns false the call to CreateDefaultControls is never made from PropertyDataControl. The default implementation only makes a call to CreateDefaultControls if the PropertyData.IsNull property returns false. This can be a breaking change since a developer may have an implementation for the CreateDefaultControls that creates controls even if the IsNull-property returns true. In this case, the fix is to override the ShouldCreateDefaultControls method and always return true.

Note: these changes are not available in the CMS 6 R2 Beta release.

Jan 27, 2011

Comments

Jan 27, 2011 02:48 PM

Nice tweak, simple but could prove useful

Oskar Zetterberg
Oskar Zetterberg Jan 27, 2011 02:56 PM

Excellent, i´ve been waiting for something like this. Now we can get the markup the way we want it without the need of ugly hacks :).

Jan 27, 2011 04:08 PM

How does this relate to the AttributeSourceControl property? I've used that to extract information from the container control (EPiServer:Property), like this:
https://www.coderesort.com/p/epicode/browser/MakingWaves.EPiImage/6.x/EPiImage/Properties/EPiImagePropertyControl.cs#L175

Did I do it wrong?

Jan 28, 2011 04:03 PM

Steve: Your code will still work. It's up to the implementation in CreateDefaultControls to make use/copy any attributes. It's also up to this method to decide if the custom tag name makes any sense for your property. We have gone through the built in property controls and implemented support to either directly create a tag with the custom name or in some cases (for instance links) wrap the inner control in the custom tag (

[Link text]

).

Please login to comment.
Latest blogs
What’s next after Google Optimize’s sunsetting?

Google has announced that it is sunsetting the Google Optimize and Optimize 360 services, forcing customers to explore new platforms and invest in...

Ynze | Jan 31, 2023 | Syndicated blog

What’s next after Google Optimize’s sunsetting?

Google has announced that it is sunsetting the Google Optimize and Optimize 360 services, forcing customers to explore new platforms and invest in...

Ynze | Jan 31, 2023 | Syndicated blog

Migrating from Providers to CMS 12 ASP.NET Identity with cookie tweaks

Notes on migrating a multi-site from Membership and Role Providers to ASP.NET Identity and changing cookie options dynamically.

Johan Kronberg | Jan 30, 2023 | Syndicated blog

Integrating generative AI in Optimizely CMS: A quick test with OpenAI

Some of the new AI services have received a lot of attention recently. Can you integrate them in Optimizely CMS? Of course, you can!

Tomas Hensrud Gulla | Jan 30, 2023 | Syndicated blog