New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

RadAjaxPanel is one of the two major controls of the Telerik RadAjax suite. The other one is RadAjaxManager. The RadAjaxPanel control provides the easiest way to AJAX-enable ASP.NET web control(s). To do this you simply need to place the controls that you want ajaxified into RadAjaxPanel and Telerik RadAjax takes care of the rest. Best of all this happens transparently to the framework and the controls that are being ajaxified.

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
[ToolboxBitmap(typeof(RadAjaxLoadingPanel), "Toolbox.Icons.Ajax.png")]
[TelerikToolboxCategory("Miscellaneous")]
[EmbeddedSkin("Ajax")]
[EmbeddedSkin("Ajax", "Default")]
[ClientScriptResource("Telerik.Web.UI.RadAjaxLoadingPanel", "Telerik.Web.UI.Ajax.Ajax.js")]
[ClientScriptResource("Telerik.Web.UI.RadAjaxLoadingPanel", "Telerik.Web.UI.Common.Navigation.OverlayScript.js")]
[RequiredScript(typeof(Core))]
[RequiredScript(typeof(jQuery))]
public class RadAjaxLoadingPanel : Panel, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, ISkinnableControl, IControl

Inheritance: objectControlWebControlPanelRadAjaxLoadingPanel

Implements: IAttributeAccessorIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorIParserAccessorIScriptControlISkinnableControlIUrlResolutionService...

Inherited Members Panel.CreateControlStyle()Panel.RenderBeginTag(HtmlTextWriter)Panel.RenderEndTag(HtmlTextWriter)Panel.BackImageUrlPanel.DefaultButtonPanel.DirectionPanel.GroupingTextPanel.HorizontalAlignPanel.SupportsDisabledAttributePanel.ScrollBarsPanel.WrapWebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.LoadViewState(object)WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.SaveViewState()WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SkinIDWebControl.TabIndexWebControl.TagKeyWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind()Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.OnInit(EventArgs)Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Properties

Gets or sets animation duration in milliseconds. Default value is 0, i.e. no animation.

C#
public int AnimationDuration { get; set; }

Gets or sets the position of the skin background image. Default value is center.

C#
public AjaxLoadingPanelBackgroundPosition BackgroundPosition { get; set; }

Gets or sets transparency of the loading panel without affecting the icon. Default value is 0 percents.

C#
public int BackgroundTransparency { get; set; }
C#
protected virtual string CssClassFormatString { get; }

Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests

C#
public virtual bool EnableAjaxSkinRendering { get; set; }

Implements: ISkinnableControl.EnableAjaxSkinRendering

If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.

When set to true enables support for WAI-ARIA

C#
public bool EnableAriaSupport { get; set; }

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

C#
public virtual bool EnableEmbeddedBaseStylesheet { get; set; }

Implements: ISkinnableControl.EnableEmbeddedBaseStylesheet

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

Gets or sets the value, indicating whether to render script references to the embedded scripts or not.

C#
public virtual bool EnableEmbeddedScripts { get; set; }

Implements: ISkinnableControl.EnableEmbeddedScripts

If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.

Gets or sets the value, indicating whether to render links to the embedded skins or not.

C#
public virtual bool EnableEmbeddedSkins { get; set; }

Implements: ISkinnableControl.EnableEmbeddedSkins

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

Defines whether the transparency set in the skin will be applied. Default value is True.

C#
public bool EnableSkinTransparency { get; set; }

Gets or sets a value specifying the delay in milliseconds, after which the RadAjaxLoadingPanel will be shown. If the request returns before this time, the RadAjaxLoadingPanel will not be shown.

C#
public int InitialDelayTime { get; set; }

The IsSticky property of the Loading Panel controls where the panel will appear during the AJAX request. If this property is set to true, the panel will appear where you have placed it on your webform. If this property is set to false, the Loading panel will appear on the place of the updated control(s).

By default this property is set to false.

C#
public bool IsSticky { get; set; }

Gets or sets a value that specifies the minimum time in milliseconds that the RadAjaxLoadingPanel will last. The control will not be updated before this period has passed even if the request returns. This will ensure more smoother interface for your page.

C#
public int MinDisplayTime { get; set; }

Gets or sets the value, indicating whether the loading panel will be displayed over the entire visible area of the page.

C#
[ClientControlProperty]
public virtual bool Modal { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("hiding")]
public string OnClientHiding { get; set; }
C#
[ClientControlEvent]
[ClientPropertyName("showing")]
public string OnClientShowing { get; set; }

Gets or sets a value indicating whether the loading panel will create an overlay element to ensure popups are over a flash element or Java applet.

C#
[Browsable(true)]
[Bindable(true)]
public bool Overlay { get; set; }
Property Value:

The default value is false.

Gets or sets the value, indicating whether to register with the ScriptManager control on the page.

C#
public virtual bool RegisterWithScriptManager { get; set; }

Implements: IControl.RegisterWithScriptManager

If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.

Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css.

C#
[ClientControlProperty]
public RenderMode RenderMode { get; set; }

Implements: ISkinnableControl.RenderMode

Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.

Returns resolved RenderMode should the original value was Auto

C#
public virtual RenderMode ResolvedRenderMode { get; }

Implements: ISkinnableControl.ResolvedRenderMode

Gets the real skin name for the control user interface. If Skin is not set, returns an empty string, otherwise returns Skin.

C#
protected string RuntimeSkin { get; }

Gets or sets the skin name for the control user interface.

C#
[TypeConverter("Telerik.Web.Design.SkinTypeConverter, Telerik.Web.Design, Version=2026.3.812.462, Culture=neutral, PublicKeyToken=121fae78165ba3d4")]
public virtual string Skin { get; set; }
Property Value:

A string containing the skin name for the control user interface. The default is string.Empty.

Implements: ISkinnableControl.Skin

If this property is not set, the control will not use any skin (backwards compatibility) If EnableEmbeddedSkins is set to false, the control will not register a skin CSS file automatically.

Gets or sets transparency in percentage. Default value is 0 percents.

C#
public int Transparency { get; set; }

Gets or sets the z-index of the loading panel. Default value is 90,000.

C#
public int ZIndex { get; set; }

Methods

C#
protected override void AddAttributesToRender(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: Panel.AddAttributesToRender(HtmlTextWriter)

C#
protected void ConfigureCombinedBaseSkinFile()
C#
protected void ConfigureCombinedScriptFile()
C#
protected virtual void ControlPreRender()

Returns the names of all embedded skins. Used by Telerik.Web.Examples.

C#
public virtual List<string> GetEmbeddedSkinNames()
Returns:

List<string>

Implements: ISkinnableControl.GetEmbeddedSkinNames()

C#
public string GetSkinSuffix()
Returns:

string

Implements: ISkinnableControl.GetSkinSuffix()

C#
protected override void OnLoad(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnLoad(EventArgs)

C#
protected override void OnPreRender(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnPreRender(EventArgs)

For internal use only

C#
public virtual RenderMode PreferredRenderMode(RenderModeBrowserAdaptor browser)
Parameters:browserRenderModeBrowserAdaptor

RenderModeBrowserAdaptor instance

Returns:

RenderMode

Returns the preferred RenderMode

Implements: ISkinnableControl.PreferredRenderMode(RenderModeBrowserAdaptor)

Registers the CSS references

C#
protected virtual void RegisterCssReferences()
C#
protected override void Render(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: WebControl.Render(HtmlTextWriter)

C#
protected override void RenderContents(HtmlTextWriter writer)
Parameters:writerHtmlTextWriter

Overrides: WebControl.RenderContents(HtmlTextWriter)