IMarkupExtension<T> Interface

To use properties to pass information to a custom markup extension, add public properties to the class that implements the custom markup extension. By default, any values passed as named parameters of a markup extension are considered to be of type String. However, you also can use primitive types that the Silverlight native XAML parser type conversion can handle, for example Int32. Each property that you use for passing values to the markup extension must support a public setter. It is this public setter that the Silverlight XAML parser uses to set the values upon markup extension usage. The names of the properties must match exactly the names of the arguments in the markup extension.

Use a comma as a separator between named arguments of a markup extension. Literal commas must be escaped. White space as part of the value for an argument should be enclosed in quotes or escaped.

For example, consider a custom markup extension named FirstMarkupExtension that implements two public properties named Value1 and Value2. Assume that the "local" prefix is used to map the defining assembly and namespace. The ProvideValue method uses the properties to return a string.

The following code shows the FirstMarkupExtension class.

namespace FirstCME
{
    public class FirstMarkupExtension : IMarkupExtension<string>
    {
        public object Value1 { get; set; }
        public object Value2 { get; set; }

        public string ProvideValue(IServiceProvider serviceProvider)
        {
            double _val1 = Convert.ToDouble(Value1);
            double _val2 = Convert.ToDouble(Value2);
            return (_val1 + _val2).ToString();
        }
    }
}

The following shows how to access the FirstMarkupExtension in XAML.

xmlns:local="clr-namespace:FirstCME"
    ...
<TextBlock Text="{local:FirstMarkup Value1=20, Value2=30}" />

When you run this code, the value of 50 is displayed.

Note:
By convention, you typically include an "Extension" suffix for the custom markup extension class name. When you reference the custom markup extension in XAML, the "Extension" suffix is optional.

In some cases, you will want to return an instance of the current markup extension. You can do this by having ProvideValue return the this keyword. For example, you may want to return the current markup extension because it contains state or deferred values that should not be evaluated until application run time, whereas the markup extension itself is created at parse time and does not yet have run-time state. Or, perhaps the markup extension's design has multiple properties that change based on ProvideValue behavior at parse time, and it is simpler to package these with the markup extension instance rather than a separate multi-value holding object. An example of a Silverlight markup extension that uses the returns-self pattern is Binding.