OnClientItemPopulationFailed

The OnClientItemPopulationFailed client-side event occurs when an attempt to populate a list of child items using a Web service fails.

The event handler receives two parameters:

1. The instance of the menu firing the event.

2. An eventArgs parameter containing the following methods:

• get_item returns a reference to the RadMenuItem whose child items the Web service failed to populate.

• set_cancel lets you prevent the default response to the error, which is a standard alert message displaying an error message describing the failure.

• get_cancel returns a boolean value indicating whether the default alert message was canceled.

• get_errorMessage returns an error message describing the failure.

You can use this event to substitute your own mechanism for responding to errors from the Web service. For example, the following example disables the problem item and substitutes a call to the radalert method so that the error message blends in to the look & feel of the Web site:

<script type="text/javascript">     
function populationFailed(sender, eventArgs)  
{     
    radalert(eventArgs.get_errorMessage();    
    eventArgs.get_item().disable();     
    eventArgs.set_cancel(true);  
}
</script>

<telerik:RadMenu RenderMode="Lightweight" ID="RadMenu1" runat="server" Skin="Vista" OnClientItemPopulationFailed="populationFailed">
    <WebServiceSettings Path="ProductCategories.asmx" Method="GetMenuCategories" />
    <LoadingStatusTemplate>
        <asp:Image runat="server" ID="LoadingImage" ImageUrl="~/Ajax/Img/loading7.gif" ToolTip="Loading..."
            Width="81px" Height="21px" />
    </LoadingStatusTemplate>
    <Items>
        <telerik:RadMenuItem Text="Products" ExpandMode="WebService">
        </telerik:RadMenuItem>
        <telerik:RadMenuItem Text="Purchase" ExpandMode="WebService">
        </telerik:RadMenuItem>
        <telerik:RadMenuItem Text="Support" ExpandMode="WebService">
        </telerik:RadMenuItem>
        <telerik:RadMenuItem Text="Community" ExpandMode="WebService">
        </telerik:RadMenuItem>
        <telerik:RadMenuItem Text="Corporate" ExpandMode="WebService">
        </telerik:RadMenuItem>
    </Items>
</telerik:RadMenu>
<telerik:RadWindowManager RenderMode="Lightweight" ID="RadWindowManager1" runat="server" Skin="Vista">
</telerik:RadWindowManager>

See Also

• Web Service Binding

• OnClientItemPopulating

• OnClientItemPopulated

• Overview