StackOverflow2013

Note that there are some explanatory texts on larger screens.

plurals

POHow to add a Templating to a UserControl?
primarykey
Id
11658053
data
AcceptedAnswerId
0
AnswerCount
1
ClosedDate
CommentCount
2
CommunityOwnedDate
CreationDate
2012-07-25T20:26:27.017
FavoriteCount
7
LastActivityDate
2012-09-07T20:51:00.720
LastEditDate
2017-05-23T12:24:30.050
LastEditorUserId
-1
OwnerUserId
12597
ParentId
0
PostTypeId
1
Score
20
ViewCount
7045
LastEditorDisplayName
text
Body
This question has been asked before <ul> <li><a href="http://asp.net.bigresource.com/Web-Forms-Design-Time-Support-For-Custom-Templated-User-Control-in-VS-2008-CV9nSsXpF.html" rel="nofollow noreferrer">Web Forms :: Design Time Support For Custom Templated User Control In VS 2008</a></li> <li><a href="http://www.vbforums.com/showthread.php?t=580213" rel="nofollow noreferrer">VS 2008 Using the ITemplate in a UserControl and getting a design time rendoring error</a></li> <li><a href="https://stackoverflow.com/questions/10309086/how-to-show-the-controls-for-web-user-control-in-design-time">how to show the controls for web user control in design time?</a></li> <li><a href="http://forums.asp.net/t/1291600.aspx/1" rel="nofollow noreferrer">UserControl ITemplate Property Design Time Error - Easy for a Guru...</a></li> </ul> but it doesn't hurt to ask it again: <blockquote> How do i add templating to a <code>UserControl</code> in ASP.net? </blockquote> <h2>What hasn't worked so far</h2> <ol> <li>Start with a new <code>UserControl</code>5, which i'll call <code>Contoso</code>: <pre><code>public partial class Contoso: System.Web.UI.UserControl { } </code></pre> This will allow us to use a new control:1 <pre><code><Contoso> Stuff in here <Contoso> </code></pre></li> <li>Create a public <code>ContentTemplate</code> property of type <code>ITemplate</code>: <pre><code>public partial class Contoso: System.Web.UI.UserControl { public ITemplate ContentTemplate { get; set; } } </code></pre> and add an indeterminate number of attributes to the <code>ContentTemplate</code> property:2 <pre><code>//[ParseChildren(true)] [ParseChildren(true, "ContentTemplate")] //[ParseChildren(false)] public partial class Contoso: System.Web.UI.UserControl { [TemplateContainer(typeof(ContentContainer))] [TemplateInstance(TemplateInstance.Single)] [PersistenceMode(PersistenceMode.InnerProperty)] //[PersistenceMode(PersistenceMode.InnerDefaultProperty)] [Browsable(true)] //[Browsable(false)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)] //[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)] public ITemplate ContentTemplate { get; set; } } </code></pre> this will allow us to add <code><ContentTemplate></code> to the control in our aspx file:1 <pre><code><Contoso> <ContentTemplate> Stuff in here </ContentTemplate> </Contoso> </code></pre></li> <li>Next we need to actually use the <code>ContentTemplate</code> stuff, by adding it somewhere. We do this by adding it to one of our UserControl's internal <code>div</code> elements. Starting from our <code>.aspx</code> file which was originally empty: <pre><code><%@ Control Language="C#" AutoEventWireup="true" CodeFile="Contoso.aspx.cs" Inherits="Contoso" %> </code></pre> we add a parent <code>div</code> that will hold our <code>ContentTemplate</code> stuff: <pre><code><%@ Control Language="C#" AutoEventWireup="true" CodeFile="Contoso.aspx.cs" Inherits="Contoso" %> <div id="ContentDiv" runat="server"></div> </code></pre> Then we stuff the <code>ContentTemplate</code> stuff into that parent <code>div</code> during the control's Init: <pre><code>public partial class Contoso: System.Web.UI.UserControl { protected override void OnInit(EventArgs e) { base.OnInit(e); //If there's content, then put it into our ContentDiv div if (this.ContentTemplate != null) this.ContentTemplate.InstantiateIn(ContentDiv); } [PersistenceModeAttribute(PersistenceMode.InnerProperty)] [TemplateInstanceAttribute(TemplateInstance.Single)] [Browsable(true)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)] public ITemplate ContentTemplate { get; set; } } </code></pre></li> <li>Edit: Indicate that your class implements <a href="http://msdn.microsoft.com/en-us/library/system.web.ui.inamingcontainer.aspx" rel="nofollow noreferrer"><code>INamingContainer</code></a>: <pre><code>public partial class Contoso: System.Web.UI.UserControl: INamingContainer { protected override void OnInit(EventArgs e) { base.OnInit(e); //If there's content, then put it into our ContentDiv div if (this.ContentTemplate != null) this.ContentTemplate.InstantiateIn(ContentDiv); } [PersistenceModeAttribute(PersistenceMode.InnerProperty)] [TemplateInstanceAttribute(TemplateInstance.Single)] [Browsable(true)] [DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)] public ITemplate ContentTemplate { get; set; } } </code></pre> The <a href="http://msdn.microsoft.com/en-us/library/system.web.ui.inamingcontainer.aspx" rel="nofollow noreferrer"><code>INamingContainer</code></a> interface does not have any members, and is only used to mark your <code>UserControl</code> class as something.</li> <li>And we're done3. We can now use this control in our aspx page. But first we need to "register" it at the top of our aspx page: <pre><code><%@ Register src="Contoso.ascx" TagName="Contoso" tagprefix="uc" %> </code></pre> Where: <ul> <li><code>Contoso.ascx</code> is the name of the <code>ascx</code> file</li> <li><code>Contoso</code> is the name of the element we will use to reference this user control</li> <li><code>uc</code> is a bit of text we will have to put in front of <code>uc:Contoso</code> (i use <code>uc</code> as short for user-control)</li> </ul></li> <li>Add the control to our page: <pre><code><uc:Contoso ID="Crackers" runat="server"> <ContentTemplate> Stuff goes here </ContentTemplate> </qwerty:Contoso> </code></pre></li> </ol> And we're done!4 Edit: Forgot to add the reason the above doesn't work. Visual Studio shows the error: <blockquote> Error Creating Control - Crackers Type 'System.Web.UI.UserControl' does not have a public property named 'ContentTemplate' </blockquote> <img src="https://i.stack.imgur.com/F6n2x.png" alt="enter image description here"> Which makes sense, since <code>UserControl</code> does not have a public property named <code>ContentTemplate</code> - so i can hardly blame it. <h2>Series</h2> This question is one in the ongoing Stackoverflow series, "Templating user controls": <ul> <li><a href="https://stackoverflow.com/questions/11658053/how-to-add-a-templating-to-a-usercontrol/11700540">How to add a Templating to a UserControl?</a></li> <li><a href="https://stackoverflow.com/questions/12323303/how-to-inherit-from-control-rather-than-usercontrol">How to inherit from Control, rather than UserControl?</a></li> <li><a href="https://stackoverflow.com/questions/12321621/usercontrol-has-ispostback-but-control-does-not/12321692">UserControl has IsPostBack, but Control does not</a></li> <li><a href="https://stackoverflow.com/questions/11656637/usercontrol-does-not-have-public-property-named-contenttemplate">UserControl does not have public property named ContentTemplate</a></li> <li><a href="https://stackoverflow.com/questions/12325192/how-do-i-specify-codefilebaseclass-from-web-config">How do i specify CodeFileBaseClass from web.config?</a></li> </ul> <h2>Bonus Reading</h2> <ul> <li><a href="http://msdn.microsoft.com/en-us/library/36574bf6.aspx" rel="nofollow noreferrer">How to: Create Templated ASP.NET User Controls</a></li> <li><a href="http://leedale.wordpress.com/2007/08/11/creating-a-templated-user-control-with-aspnet-20/" rel="nofollow noreferrer">Creating a Templated User Control with ASP.Net 2.0</a></li> <li><a href="http://geekswithblogs.net/CodeSpeaker/archive/2009/07/04/templated-user-controls-in-asp.net-for-better-maintainability.aspx" rel="nofollow noreferrer">Templated User Controls in ASP.NET for Better Maintainability</a></li> </ul> <h2>Footnotes</h2> <ul> <li>1 You can't ever use that syntax. That's just an easy to read and understand form.</li> <li>2 Nobody knows what attributes to add, or why. Add more or less attribute to taste.</li> <li>3 Not done. Done with the UserControl, but not our work.</li> <li>4 Not done; it doesn't work.</li> <li>5 in the web-site (not a web application, not in a separate assembly)</li> </ul>
Tags
<asp.net><user-controls><templating><webusercontrol>
Title
How to add a Templating to a UserControl?
singulars
PostAcceptedAnswerId
1. This table or related slice is empty.
PostParentId
1. This table or related slice is empty.
PostTypePostTypeId
1. PTQuestion
UserLastEditorUserId
1. USCommunity
UserOwnerUserId
1. USIan Boyd
plurals
PostLinksPostIdRelatedPostId
1. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
2. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
3. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
PostLinksRelatedPostIdPostId
1. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
2. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
3. PL
 singulars
 LinkTypeLinkTypeId
 LTLinked
PostsAcceptedAnswerId
1. This table or related slice is empty.
PostsParentIdCreationDate
1. PO
 singulars
 PostTypePostTypeId
 PTAnswer
VotesPostIdCreationDate
1. VO
 singulars
 PostPostId
 POHow to add a Templating to a UserControl?
 UserUserId
 USIcarus
 VoteTypeVoteTypeId
 VTFavorite
2. VO
 singulars
 PostPostId
 POHow to add a Templating to a UserControl?
 UserUserId
 This table or related slice is empty.
 VoteTypeVoteTypeId
 VTUpMod
3. VO
 singulars
 PostPostId
 POHow to add a Templating to a UserControl?
 UserUserId
 USIan Boyd
 VoteTypeVoteTypeId
 VTBountyStart
CommentsPostId
1. COYour footnotes would be easier to read if you insert them inline in your text, it's annoying to scroll down just to read the note
 singulars
 PostPostId
 POHow to add a Templating to a UserControl?
 UserUserId
 USJupaol
2. CO@Jupaol The footnotes don't add anything relevant to the question, and are only there to ward off nitpickers who want to nit-pick unimportant details. It would be a shame to litter the question in-line with such unimportant nonsense.
 singulars
 PostPostId
 POHow to add a Templating to a UserControl?
 UserUserId
 USIan Boyd

Querying!

Guidance

A row detail

Detail views are divided into sections. All the information in the data section comes from columns in the selected row. The other sections display data from other, related rows.

Related data can be related in a to-one or a to-many fashion. Captions of data related in a to-many fashion link to a list view showing a filtered view of the table.

Try moving around until you find a non-empty to-many entry and click on the label to get to one. You can move back to the root by clicking on the database name in the header.