I do a lot of work with control templates, and one of the pieces of functionality that I've always wanted is the ability
to build a ITemplate from a
string. Throughout the years, the topic has come up from time
to time, and I never really found anything about how
to do it. though I have run across a number of postings from people who are also wanting the same capability. As I was messing around with things the other day, I stumbled on how
to make it work and I feel really foolish for not figuring it out sooner. ITemplate is an interface that exposes a single method named InstantiateIn. I've been searching for years for some magical .NET framework component that would take a
string and convert it into an ITemplate, when all along I could just build my own. Here's the code: /// <summary> /// Allows string-based ITempalte implementations /// </summary> public class StringTemplate : ITemplate { #region Constructor(s) //////////////////////////////////////////////////////////////////////////////////////////// /// <summary> /// Constructor /// </summary> /// <param name="template">String based version of the control template.</param> public StringTemplate(string template) { Template = template; } /// <summary> /// Constructor /// </summary> /// <param name="template">String based version of the control template.</param> /// <param name="copyToContainer">True
to copy intermediate container contents
to the instantiation container, False
to leave the intermediate container in place.</param> public StringTemplate(string template, bool copyToContainer) { Template = template; CopyToContainer = copyToContainer; } //////////////////////////////////////////////////////////////////////////////////////////// #endregion #region Properties //////////////////////////////////////////////////////////////////////////////////////////// /// <summary> ///
String based template /// </summary> public
string Template { get; set; } /// <summary> /// When a StringTemplate is instantiated it is created inside an intermediate control /// due
to limitations of the .NET Framework. Specifying True for the CopyToContainer /// property copies all the controls from the intermediate container into instantiation /// container passed
to the InstantiateIn method. /// </summary> public bool CopyToContainer { get; set; } //////////////////////////////////////////////////////////////////////////////////////////// #endregion #region ITemplate Members //////////////////////////////////////////////////////////////////////////////////////////// /// <summary> /// Creates the template in the specified control. /// </summary> /// <param name="container">Control in which
to make the template</param> public void InstantiateIn(Control container) { Control tempContainer = container.Page.ParseControl(Template); if (CopyToContainer) { for (int i = tempContainer.Controls.Count - 1; i >= 0; i--) { Control tempControl = tempContainer.Controls[i]; tempContainer.Controls.RemoveAt(i); container.Controls.AddAt(0, tempControl); } } else { container.Controls.Add(tempContainer); } } //////////////////////////////////////////////////////////////////////////////////////////// #endregion } //class Converting a
string into a user control is fairly easy using the ParseControl method from a Page
object. Fortunately, the container passed into the InstantiateIn method has a Page property. One caveat, however, is that the Page property only has a reference
to a Page if the container is located ON the page. If you run into this problem, you may have
to find a creative way
to get the Page reference (you can add it
to the constructor, store it in the request context, etc). Another issue that I ran into is that the ParseControl creates a new control, parses the
string template, places any controls defined in the template onto the new control it created, and returns that new control with the template on it. You cannot pass in your own container. Adding this directly
to the container provided as a parameter in the InstantiateIn means that you end up with an additional "level" in the control hierarchy.
To avoid this, I added code in that removes each control from the intermediate container and places it into the actual container. I am not, however, sure about the performance penalty associated with moving a bunch of control from one place
to another, nor am I completely sure if doing such a move completely screws something up if you have a code behind, etc. It seems
to work when it's just a template, but my testing was ever-so-slightly shy of thorough when it comes
to other crazy scenarios. As a catch-all, I added a Boolean property called CopyToContainer that allows you
to turn the copying on or off depending on your desires and needs. Technorati Tags: .NET,ASP.NET,ITemplate,Development,C#,Custom Controls,Server Controls
