/// <summary>
/// Extension methods for the <see cref="Control"/> class.
/// </summary>
public static class ControlExtensions
{
	/// <summary>
	/// Evaluates a data-binding expression at run time and returns a HTML-encoded result.
	/// </summary>
	/// <param name="control">The control this extension method is attached to.</param>
	/// <param name="expression">
	/// The navigation path from the container object to the public property value to be placed in the bound control property. 
	/// This must be a string of property or field names separated by periods, such as Tables[0].DefaultView.[0].Price
	/// </param>
	/// <remarks>
	/// Because this method performs late-bound evaluation, using reflection at run time, it can cause performance 
	/// to noticeably slow compared to standard ASP.NET data-binding syntax. Use this method judiciously.
	/// </remarks>
	/// <returns>A HTML-encoded <see cref="String"/> instance that results from the evaluation of the data-binding expression.</returns>
	public static string EncodeEval( this Control control, string expression )
	{
		return HttpUtility.HtmlEncode( DataBinder.Eval( control.Page.GetDataItem(), expression ).ToString() );
	}


	/// <summary>
	/// Evaluates a data-binding expression at run time and returns a HTML-encoded result.
	/// </summary>
	/// <param name="control">The control this extension method is attached to.</param>
	/// <param name="expression">
	/// The navigation path from the container object to the public property value to be placed in the bound control property. 
	/// This must be a string of property or field names separated by periods, such as Tables[0].DefaultView.[0].Price
	/// </param>
	/// <param name="format">
	/// A .NET Framework format string (like those used by <see cref="String.Format"/>) that converts the <see cref="Object"/> instance 
	/// returned by the data-binding expression to a <see cref="String"/> object. 
	/// </param>
	/// <remarks>
	/// Because this method performs late-bound evaluation, using reflection at run time, it can cause performance 
	/// to noticeably slow compared to standard ASP.NET data-binding syntax. Use this method judiciously, particularly when string formatting is not required.
	/// </remarks>
	/// <returns>A HTML-encoded <see cref="String"/> instance that results from the evaluation of the data-binding expression.</returns>
	public static string EncodeEval( this Control control, string expression, string format )
	{
		return HttpUtility.HtmlEncode( DataBinder.Eval( control.Page.GetDataItem(), expression, format ).ToString() );
	}
}