Try our conversational search powered by Generative AI!

Stefan Forsberg
Jul 30, 2010
(0 votes)

Why you have to mark your properties as virtual when using PTB

A colleague asked me why all the properties that are to be mapped with PageTypeBuilder has to be virtual. This is sort of interesting and everyone that’s using PTB might not be aware of the reason so I thought that that merits a quick post about it.



PTB uses something called Interceptors which are used to (wait for it) intercept calls. The framework PTB uses for this is called DynamicProxy and is part of the Castle fame. The reason the properties have to be virtual is that the DynamicProxy needs to override (in the case of PTB) your properties to be able to run the code you (or Joel in this case) specify in the interception.

Why intercept?

A standard property using PTB looks something like this

   1: [PageTypeProperty(Type = typeof(PropertyString))]
   2: public virtual string Heading { get; set; }

and yet when calling CurrentPage.Heading it automagically has the value of the property CurrentPage[“Heading”]. This is due to the interception of the property Heading. Since the logic of how to handle the getting and setting of properties is the same for all properties you can use the above code instead of what’s actually happening under the covers which is something like this

   1: public virtual string Heading
   2: {
   3:     get
   4:     {
   5:         return this["Heading"] as string;
   6:     }
   7:     set
   8:     {
   9:         this.SetValue("Heading", value);
  10:     }
  11: }

So PTB uses interception both to be able to infer which property you’re getting/setting as well as handle the actually getting/setting which stays the same for all properties.


How the magic happens

PTB first does some wiring so that the interception is activated for the TypedPageData (see the class TypedPageActivator). Since we’re only interested in intercepting those properties we talked about above PTB uses a generation hook for this

   1: public bool ShouldInterceptMethod(Type type, MethodInfo memberInfo)
   2: {
   3:     return (memberInfo.IsGetterOrSetterForPropertyWithAttribute(typeof(PageTypePropertyAttribute)) && memberInfo.IsCompilerGenerated());
   4: }

So when you access one of the properties the generated proxy intercepts the call. The actual getting and setting of values is handled by the Intercept method in the class PageTypePropertyInterceptor.

   1: public void Intercept(IInvocation invocation)
   2: {
   3:     TypedPageData invocationTarget = (TypedPageData) invocation.InvocationTarget;
   4:     string propertyName = invocation.Method.GetPropertyName();
   5:     if (invocation.Method.IsGetter())
   6:     {
   7:         invocation.ReturnValue = invocationTarget[propertyName];
   8:         if ((invocation.ReturnValue == null) && (invocation.Method.ReturnType == typeof(bool)))
   9:         {
  10:             invocation.ReturnValue = false;
  11:         }
  12:     }
  13:     else
  14:     {
  15:         invocationTarget.SetValue(propertyName, invocation.Arguments[0]);
  16:     }
  17: }

As you can see on line 4 it uses the name of the property to avoid having magic string. It then basically does what the code above that explicitly handled the getting and setting does so that you won’t have to.

Jul 30, 2010


Please login to comment.
Latest blogs
Optimizely and the never-ending story of the missing globe!

I've worked with Optimizely CMS for 14 years, and there are two things I'm obsessed with: Link validation and the globe that keeps disappearing on...

Tomas Hensrud Gulla | Apr 18, 2024 | Syndicated blog

Visitor Groups Usage Report For Optimizely CMS 12

This add-on offers detailed information on how visitor groups are used and how effective they are within Optimizely CMS. Editors can monitor and...

Adnan Zameer | Apr 18, 2024 | Syndicated blog

Azure AI Language – Abstractive Summarisation in Optimizely CMS

In this article, I show how the abstraction summarisation feature provided by the Azure AI Language platform, can be used within Optimizely CMS to...

Anil Patel | Apr 18, 2024 | Syndicated blog

Fix your Search & Navigation (Find) indexing job, please

Once upon a time, a colleague asked me to look into a customer database with weird spikes in database log usage. (You might start to wonder why I a...

Quan Mai | Apr 17, 2024 | Syndicated blog