ControlBuilder.HasBody Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Determines if a control has both an opening and closing tag. This method is called by the ASP.NET page framework.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public virtual bool HasBody()

Return Value

Type: System.Boolean

true if the control has an opening and closing tag; otherwise, false.

This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

This example overrides the OnAppendToParentBuilder method to check the ControlType property to determine what type of control this builder is applied to. If it is a CustomTextBox, the builder checks whether the value of the HasAspCode property is included in the control. If so, an exception is thrown, if not the HasBody method is called.

using System;
using System.Web.UI;
using System.Web;
using System.Security.Permissions;

namespace ASPNET.Samples
{
	[
	AspNetHostingPermission(SecurityAction.Demand,
		Level=AspNetHostingPermissionLevel.Minimal)
	]
	public class AppendControlBuilder : ControlBuilder
	{
		// Override the OnAppendToParentBuilder method.
		public override void OnAppendToParentBuilder(ControlBuilder parentBuilder)
		{
            // Check whether the type of the control this builder
            // is applied to is CustomTextBox. If so, check whether
            // ASP code blocks exist in the control. If so, call
            // throw an Exception, if not, call the HasBody method.        
			if (ControlType == Type.GetType("CustomTextBox"))
			{
				if (HasAspCode)
					throw new Exception("This control cannot contain code blocks.");
				else
					HasBody();
			}
		}
	}
}

.NET Framework
Available since 1.1
Return to top
Show: